Aletheia

Aletheia is a conversational AI platform designed for modern AI products. It combines real-time chat, structured memory, and modular orchestration into a scalable developer-friendly system.

Memory System

Aletheia implements a structured conversational memory architecture inspired by modern research in persistent LLM systems.

Reference:
Persistent Memory for Conversational AI Systems

• Context-aware memory retrieval
• Long-term interaction persistence
• Memory summarization pipelines
• Graph-driven agent orchestration

Product Interface

Model Selection

Personalization Controls

Conversational Interface

Architecture Overview

Frontend

• Next.js
• Component-driven UI system
• NextAuth authentication

Backend

• FastAPI service layer
• LangGraph / LangChain orchestration
• Groq inference integration

Infrastructure

• PostgreSQL persistence (NeonDB)
• Docker containerization
• Compose-based local orchestration

Known Platform Constraint

NeonDB Free Tier Sleep

The database may enter idle suspension.

Impact:

• First request latency
• Temporary connection failure

Mitigation:

• Warm-up query at startup
• Retry logic in client

🛠️ Local Development

Client

cd client
npm install
npm run dev

Environment:

GITHUB_CLIENT_ID=
GITHUB_CLIENT_SECRET=
NEXTAUTH_SECRET=
NEXT_PUBLIC_API_URL=

Server

uv venv .venv
./.venv/Scripts/activate
docker build -t server .
docker run -p 8080:8080 server

Environment:

GROQ_API_KEY=
DB_URL=
PINECONE_API_KEY=
VOYAGE_API_KEY=

docker compose up