dograh/AGENTS.md

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

Starting Services

# Start infrastructure services (postgres, redis, minio)
./scripts/start_services.sh --dev

# Stop all services
./scripts/stop_services.sh

Environment Configuration

• api/.env - Backend environment variables
• ui/.env - Frontend environment variables