{"id":29031642,"url":"https://github.com/digispect-intel/business_voice_agent_backend","last_synced_at":"2026-04-21T16:33:49.932Z","repository":{"id":301045945,"uuid":"1006586248","full_name":"digispect-intel/business_voice_agent_backend","owner":"digispect-intel","description":"A voice-enabled AI assistant backend for a business website. This backend powers business_voice_agent_frontend, providing real-time voice interaction capabilities using Restack AI.","archived":false,"fork":false,"pushed_at":"2025-06-24T21:42:31.000Z","size":12,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-24T22:35:16.156Z","etag":null,"topics":["deepgram","elevenlabs","fasthtml","livekit","openai","restack"],"latest_commit_sha":null,"homepage":"https://business-voice-agent.digispectintelligence.solutions/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/digispect-intel.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-22T15:37:59.000Z","updated_at":"2025-06-24T22:23:21.000Z","dependencies_parsed_at":"2025-06-24T22:35:19.973Z","dependency_job_id":"a0e623e5-df35-494a-87f6-7e6acffc446d","html_url":"https://github.com/digispect-intel/business_voice_agent_backend","commit_stats":null,"previous_names":["digispect-intel/business_voice_agent_backend"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/digispect-intel/business_voice_agent_backend","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digispect-intel%2Fbusiness_voice_agent_backend","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digispect-intel%2Fbusiness_voice_agent_backend/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digispect-intel%2Fbusiness_voice_agent_backend/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digispect-intel%2Fbusiness_voice_agent_backend/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/digispect-intel","download_url":"https://codeload.github.com/digispect-intel/business_voice_agent_backend/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digispect-intel%2Fbusiness_voice_agent_backend/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262044447,"owners_count":23249750,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["deepgram","elevenlabs","fasthtml","livekit","openai","restack"],"created_at":"2025-06-26T10:04:50.782Z","updated_at":"2026-04-21T16:33:44.891Z","avatar_url":"https://github.com/digispect-intel.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Business Voice Agent - Backend\n\n- **Live Example:** [AI Agent Dave](https://business-voice-agent.digispectintelligence.solutions/)\n- **Frontend Repository:** [business_voice_agent_frontend](https://github.com/digispect-intel/business_voice_agent_frontend)\n- **Interest Form** [Share your interest by completing this form](https://forms.digispectintelligence.solutions/r4RzLd)\n\nA voice-enabled AI assistant backend for David McGrath's business website (digispectintelligence.com). This backend powers Agent Dave, providing real-time voice interaction capabilities using Restack AI.\n\n## Overview\n\nAgent Dave is designed to assist visitors of Digispect Intelligence by providing information about David's profile, expertise, and services. This backend handles the voice processing pipeline, AI model integration, and real-time communication.\n\n## Prerequisites\n\n- Docker (for running Restack)\n- Python 3.10 or higher\n- Restack (docker image for local development and account for web hosting)\n- Livekit account (for live chat)\n- Deepgram account (for speech-to-text transcription)\n- ElevenLabs account (for text-to-speech and voice cloning)\n- OpenAI (for AI logic) \n\n## Configuration\n\n1. Copy the `.env.example` file in the `agent` subfolder and the `.env.local.example` file in the `livekit_pipeline` subfolder (and rename by removing the `.example` suffixes):\n\n2. Configure the following services and update the values in the above mentioned files:\n\n   ### Livekit Setup\n   - Sign up at [Livekit](https://livekit.io)\n   - In your `.env` and `.env.local` files:\n     - Set `LIVEKIT_URL` to `WEBSOCKET_URL` value\n     - Set `LIVEKIT_API_KEY` to `API_KEY` value\n     - Set `LIVEKIT_API_SECRET` to `API_SECRET` value\n\n   ### Deepgram Setup\n   - Sign up at [Deepgram](https://deepgram.com)\n   - Obtain an API key and add to `DEEPGRAM_API_KEY` in `.env.local` file\n\n   ### ElevenLabs Setup\n   - Sign up at [ElevenLabs](https://try.elevenlabs.io/business_voice_agent)\n   - Add `ELEVEN_API_KEY` and `ELEVENLABS_VOICE_ID`to `.env.local` file\n\n   ### OpenAI Setup\n   - Sign up at [OpenAI](https://platform.openai.com)\n   - Add `OPENAI_API_KEY`to `.env` file\n\n## Installation and Setup\n\n**Note:** Make sure to also set up the [business_voice_agent_frontend](https://github.com/digispect-intel/business_voice_agent_frontend) repository for the complete system.\n\n### 1. Start Restack\n\n```bash\ndocker run -d --pull always --name restack -p 5233:5233 -p 6233:6233 -p 7233:7233 -p 9233:9233 -p 10233:10233 ghcr.io/restackio/restack:main\n```\n\n### 2. Start Restack Agent with Voice\n\n#### Create Python environment\n\nUsing uv:\n```bash\ncd agent\nuv venv \u0026\u0026 source .venv/bin/activate\nuv sync\nuv run dev\n```\n\nUsing pip:\n```bash\ncd agent\npython -m venv .venv \u0026\u0026 source .venv/bin/activate\npip install -e .\npython -c \"from src.services import watch_services; watch_services()\"\n```\n\n### 3. Start Livekit Voice Pipeline\n\n#### Create Python environment\n\nUsing uv:\n```bash\ncd livekit_pipeline\nuv venv \u0026\u0026 source .venv/bin/activate\nuv sync\nuv run python src/pipeline.py dev\n```\n\nUsing pip:\n```bash\ncd livekit_pipeline\npython -m venv .venv \u0026\u0026 source .venv/bin/activate\npip install -e .\npython src/pipeline.py dev\n```\n\n## Usage\n\nThis backend works in conjunction with the [business_voice_agent_frontend](https://github.com/digispect-intel/business_voice_agent_frontend). Please refer to the frontend repository for complete usage instructions on how to interact with the voice assistant system.\n\n## Deployment\n\nTo deploy on Restack Cloud:\n1. Create an account at https://console.restack.io\n2. Follow the deployment instructions in the [Restack documentation](https://docs.restack.io/restack-cloud/introduction)\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Contact\n\nFor questions or support, contact david.mcgrath@digispectintelligence.com\n\n## References\n\nThis repo is based on the examples here:\n- https://github.com/AnswerDotAI/fasthtml-example\n- https://github.com/restackio/examples-python/tree/main/agent_voice/livekit\n- https://github.com/livekit/agents/tree/main/examples/voice_agents\n- https://github.com/livekit/client-sdk-js/tree/main/examples","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdigispect-intel%2Fbusiness_voice_agent_backend","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdigispect-intel%2Fbusiness_voice_agent_backend","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdigispect-intel%2Fbusiness_voice_agent_backend/lists"}