mirror of
https://github.com/dograh-hq/dograh.git
synced 2026-07-10 11:12:13 +02:00
* chore: cleaup mps v1 billing * chore: remove legacy file upload path * chore: implement review comments
1.6 KiB
1.6 KiB
Dograh - Project Overview
Dograh is a voice AI platform for building and deploying conversational AI agents with telephony and WebRTC support.
Project Structure
dograh/
├── api/ # Backend - FastAPI application
├── ui/ # Frontend - Next.js application
├── scripts/ # Helper scripts for local development
├── docs/ # Mintlify documentation
├── pipecat/ # Pipecat framework (git submodule)
├── docker-compose.yaml # Production/OSS deployment
├── docker-compose-local.yaml # Local development services
Tech Stack
- Backend: Python with FastAPI
- Frontend: Next.js 15 with React 19, TypeScript, Tailwind CSS
- Database: PostgreSQL with SQLAlchemy (async)
- Cache/Queue: Redis with ARQ for background tasks
- Storage: MinIO (S3-compatible) for audio files
Local Development
Contributor setup and service startup are documented in docs/contribution/setup.mdx.
Environment Configuration
api/.env- Backend environment variables. Source this when running repo-owned backend scripts against the dev DB (e.g.python -m scripts.dump_docs_openapi).api/.env.test- Test-only environment variables. Source this when running pytest so tests hit the test DB and never the dev/prod credentials inapi/.env.ui/.env- Frontend environment variables
Typical invocation:
# Tests
source venv/bin/activate && set -a && source api/.env.test && set +a && python -m pytest api/tests/...
# Backend scripts
source venv/bin/activate && set -a && source api/.env && set +a && python -m scripts.dump_docs_openapi