Cortex AI

Multi-tenant AI orchestration platform — chat, document Q&A, database queries, MCP tool use, and more.

Quick Start (npx)

The fastest way to get Cortex running — no clone needed:

npx aicortexx

This will:

1. Walk you through a setup wizard (MongoDB URI, secrets, admin account)
2. Build the frontend automatically
3. Open your browser to http://localhost:5000

Options

npx aicortexx                   # Start (setup wizard on first run)
npx aicortexx setup             # Re-run the setup wizard
npx aicortexx build             # Rebuild frontend only
npx aicortexx --port 3000       # Run on a custom port
npx aicortexx --version         # Show version

Manual Setup (for development)

git clone https://github.com/AnandPilania/cortex-ai
cd cortex-ai
npm install
cp .env.example .env
# Edit .env with your MongoDB URI, JWT secret, etc.
npm run dev       # Starts both API server (port 5000) and Vite dev server (port 5173)

Prerequisites

• Node.js 18+ — nodejs.org
• MongoDB — local install or MongoDB Atlas (free tier works)
• ChromaDB — for document Q&A: pip install chromadb && chroma run (or use the Docker image)

Features

• 🧠 Multi-model AI — OpenAI, Azure OpenAI, any OpenAI-compatible endpoint
• 💬 Chat — multi-turn conversations with compression for long contexts
• 📄 Document Q&A — upload PDFs, DOCX, TXT; ask questions with RAG
• 🗄️ Database Chat — natural language queries against PostgreSQL, MySQL, MongoDB
• 🔌 MCP Servers — one-click install from a curated marketplace of 20+ servers
• 📊 Data Visualization — auto-renders charts/tables from query results
• 📧 Email — AI-powered inbox triage and draft generation
• 👥 Multi-tenant — isolated workspaces, roles, per-tenant model configuration

Environment Variables

See .env.example for full documentation.

| Variable | Required | Description | | ---------------- | -------- | --------------------------------------------- | | MONGODB_URI | ✓ | MongoDB connection string | | JWT_SECRET | ✓ | Random string for JWT signing | | ENCRYPTION_KEY | ✓ | 32-char string for credential encryption | | PORT | | Server port (default: 5000) | | CHROMA_URL | | ChromaDB URL (default: http://localhost:8000) | | ADMIN_EMAIL | | Auto-create admin on first boot | | ADMIN_PASSWORD | | Auto-create admin on first boot |

License

MIT