https://github.com/digispect-intel/business_voice_agent_frontend
A FastHTML-based frontend for a Business Voice Agent, an AI assistant for a business website. This frontend provides a user interface for interacting with business_voice_agent_backend.
https://github.com/digispect-intel/business_voice_agent_frontend
deepgram elevenlabs fasthtml livekit openai restack
Last synced: 3 months ago
JSON representation
A FastHTML-based frontend for a Business Voice Agent, an AI assistant for a business website. This frontend provides a user interface for interacting with business_voice_agent_backend.
- Host: GitHub
- URL: https://github.com/digispect-intel/business_voice_agent_frontend
- Owner: digispect-intel
- License: mit
- Created: 2025-06-22T15:32:09.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-06-24T21:42:21.000Z (4 months ago)
- Last Synced: 2025-06-24T22:35:16.118Z (4 months ago)
- Topics: deepgram, elevenlabs, fasthtml, livekit, openai, restack
- Language: Python
- Homepage: https://business-voice-agent.digispectintelligence.solutions/
- Size: 6.84 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Business Voice Agent - Frontend
- **Live Example:** [AI Agent Dave](https://business-voice-agent.digispectintelligence.solutions/)
- **Backend Repository:** [business_voice_agent_backend](https://github.com/digispect-intel/business_voice_agent_backend)
- **Interest Form** [Share your interest by completing this form](https://forms.digispectintelligence.solutions/r4RzLd)
A FastHTML-based frontend for Agent Dave, an AI assistant for David McGrath's business website (digispectintelligence.com). This frontend provides the user interface for interacting with Agent Dave.
## Overview
This frontend allows visitors to interact with Agent Dave, an AI assistant that can provide information about David McGrath's profile, expertise, and services at Digispect Intelligence. The application is built using FastHTML and provides voice-enabled interaction capabilities.
## Features
- Interactive UI for communicating with Agent Dave
- Voice-enabled interaction capabilities
- Information about David's profile and past experiences
- Exploration of Data Science and AI business applications
- Responsive design for all devices
## Prerequisites
- Python 3.8 or higher
- [business_voice_agent_backend](https://github.com/digispect-intel/business_voice_agent_backend) running locally
## Configuration
1. Copy the `.env.example` file and rename it to `.env`:
```bash
cp .env.example .env
```
2. Update the `.env` file with your LiveKit and Restack configuration:
- `RESTACK_API_ENDPOINT`: Your Restack backend endpoint (default: http://localhost:6233)
- `LIVEKIT_API_KEY`: Your LiveKit API key
- `LIVEKIT_API_SECRET`: Your LiveKit API secret
- `LIVEKIT_URL`: Your LiveKit WebSocket URL
## Installation and Setup
**Note:** Make sure to also set up and run the [business_voice_agent_backend](https://github.com/digispect-intel/business_voice_agent_backend) repository for the complete system.
### 1. Clone the repository
```bash
git clone https://github.com/digispect-intel/business_voice_agent_frontend.git
cd business_voice_agent_frontend
```
### 2. Create a virtual environment
```bash
python -m venv .venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
```
### 3. Install dependencies
```bash
pip install -r requirements.txt
```
### 4. Run the frontend
```bash
python main.py
```
The application will be available at http://localhost:5001 (or the port specified in your FastHTML configuration).
## Usage
1. Ensure the [business_voice_agent_backend](https://github.com/digispect-intel/business_voice_agent_backend) is running
2. Start the frontend application using the steps above
3. Open your browser to the local URL
4. Click "Start Voice Chat" to begin interacting with Agent Dave
5. Speak naturally to ask questions about David's expertise and services
6. Click "End Chat" when you're finished
## Integration with Backend
This frontend connects with the [business_voice_agent_backend](https://github.com/digispect-intel/business_voice_agent_backend) repository to provide a complete AI assistant experience. The backend handles the voice processing pipeline and AI model integration.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Contact
For questions or support, contact david.mcgrath@digispectintelligence.com
## References
This repo is based on the examples here:
- https://github.com/AnswerDotAI/fasthtml-example
- https://github.com/restackio/examples-python/tree/main/agent_voice/livekit
- https://github.com/livekit/agents/tree/main/examples/voice_agents
- https://github.com/livekit/client-sdk-js/tree/main/examples