# AI Second Brain

A fully self-hosted, offline-capable knowledge management system with AI-powered retrieval, autonomous agents, and a Markdown-first philosophy.

## Quick Start

```bash
cp .env.example .env
# edit .env as needed
docker compose up -d
# wait for ollama to pull models
docker compose exec ollama ollama pull nomic-embed-text
docker compose exec ollama ollama pull mistral
# open the UI
open http://localhost:3000
```

## Architecture

See [docs/architecture.md](docs/architecture.md) for the full design.

## Components

| Service            | Port  | Description                    |
|--------------------|-------|--------------------------------|
| Web UI             | 3000  | Next.js knowledge interface    |
| RAG API            | 8000  | FastAPI retrieval service      |
| Ollama             | 11434 | Local LLM inference            |
| PostgreSQL         | 5432  | Vector + relational store      |
| Redis              | 6379  | Job queue                      |

## Documentation

- [Architecture](docs/architecture.md)
- [Setup Guide](docs/setup.md)
- [API Reference](docs/api.md)
- [Agents Guide](docs/agents.md)

## License

MIT