💬 Personal AMA - AI powered Anonymous Chat

AI-powered anonymous chat application where users can ask questions and get responses through AI personas.

• Backend: FastAPI with SlowAPI rate limiting
• Frontend: React with TypeScript
• Database: PostgreSQL with pgvector
• AI: LangChain agents with LangGraph checkpointer for memory

Prerequisites

• uv - Python package installer
• Node.js and npm
• Docker (optional, for PostgreSQL)

Quick Start

1. Setup environment

cp .env.example .env

Update the .env file with your configuration.

2. Install dependencies

Backend:

cd backend
uv pip install -r requirements.txt

Frontend:

cd frontend
npm install

3. Start PostgreSQL

Run PostgreSQL locally with Docker:

docker run -d \
  --name personal-ama-db \
  -e POSTGRES_USER=your_user \
  -e POSTGRES_PASSWORD=your_password \
  -e POSTGRES_DB=personal_ama \
  -p 5432:5432 \
  pgvector/pgvector:pg17

4. Run database migrations

cd backend
alembic upgrade head

5. Start the application

Backend:

cd backend
uvicorn app.main:app --host 0.0.0.0 --port 8000 --proxy-headers

Frontend:

cd frontend
npm run dev

The application will be available at:

• Frontend: http://localhost:5173
• Backend API: http://localhost:8000
• API Documentation: http://localhost:8000/docs

Production Deployment

For production deployment with Docker, refer to the docker-compose.yml file:

docker compose up -d

This will start:

• Frontend (Nginx) on port 3000
• Backend API on port 8000
• PostgreSQL database on port 5432
• Nginx Proxy Manager on ports 80, 443, and 81

License

Apache License 2.0