ConvoMetrics

Analytics platform that turns conversational AI interactions into actionable product insights. Provides dashboards, metrics, and real-time analytics to understand user behavior patterns and improve conversational experiences.

Tech Stack

Frontend

• React 19 with Vite dev server
• Tailwind CSS + Shadcn/ui components
• bun package manager

Backend

• FastAPI (Python 3.11+)
• SQLite embedded database
• uv (optional) or pip for Python packages

Prerequisites

• Node.js 20+
• Python 3.11+
• bun -- install from https://bun.sh
• uv (optional) -- install from https://docs.astral.sh/uv

Setup

Quick Start

chmod +x init.sh
./init.sh

This creates a Python venv, installs all dependencies, and starts both servers.

Manual Setup

Backend:

cd backend
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
uvicorn main:app --reload --port 8000

Frontend:

cd frontend
bun install
bun run dev

Environment

Source API keys from the shared environment file rather than creating a project-level .env:

source ~/.env.shared

Variables

Variable	Required	Description
DATABASE_URL	No	Database connection string (defaults to sqlite:///./data.db)
API_BASE_URL	No	Backend API URL for the frontend to call (defaults to http://your-server:8000)
LOG_LEVEL	No	Logging level (defaults to INFO)

If you extend the project to use Claude for conversation analysis, the Anthropic API key should already be available via ~/.env.shared.

Development

Frontend

The frontend runs on port 3000 with hot module replacement enabled.

Backend

The backend API runs on port 8000 with auto-reload on code changes.

API documentation (Swagger UI) is available at http://your-server:8000/docs.

Development URLs

• Frontend: http://your-server:3000
• Backend API: http://your-server:8000
• API Docs: http://your-server:8000/docs

Building for Production

Frontend:

cd frontend
bun run build

The built assets are output to frontend/dist/.

Backend:

cd backend
pip install -r requirements.txt
uvicorn main:app --host 0.0.0.0 --port 8000

Project Structure

ConvoMetrics/
  backend/
    requirements.txt
    main.py
    app/
  frontend/
    package.json
    vite.config.ts
    src/
    public/
  data/
    data.db
  init.sh
  README.md

Contributing

1. Create a feature branch (git checkout -b feature/your-feature)
2. Commit changes (git commit -m "feat: description")
3. Push (git push origin feature/your-feature)
4. Open a pull request

License

MIT