Installation
Get your local instance of Kairos running in minutes. The stack consists of a self-hosted Appwrite backend, a Python FastAPI service (Cortex), and a Next.js frontend (Prism).
Prerequisites
- Docker Desktop (running)
- Node.js 18.x or later
- Python 3.11+
- Git
1. Appwrite Backend
Run the following command to start Appwrite in Docker. This handles database, auth, and realtime events.
Terminal
docker run -it --rm \
--volume /var/run/docker.sock:/var/run/docker.sock \
--volume "$(pwd)"/appwrite:/usr/src/code/appwrite:rw \
--entrypoint="install" \
appwrite/appwrite:1.5.7
Important: After installation, go to http://localhost:80 to create your admin account and project.
2. Cortex Service
The Python backend that powers the agentic logic and Google Sync.
git clone https://github.com/project-kairos/cortex.git
cd cortex
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
cd cortex
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
3. Prism Frontend
The Next.js dashboard interface.
git clone https://github.com/project-kairos/prism.git
cd prism
npm install
npm run dev
cd prism
npm install
npm run dev