Fabled Assistant
A self-hosted second brain and project management application with integrated LLM capabilities. Write, organise, and act on your notes and tasks with the help of a local AI assistant — all running on your own hardware.
Features
- Notes — Markdown editor (Tiptap), wikilinks, backlinks, tags, version history, AI writing assist
- Tasks — Status, priority, due dates, sub-tasks, milestones, work logs
- Projects — Kanban view, milestone progress, three-panel project workspace (tasks / chat / notes)
- AI Chat — SSE streaming, RAG, tool calls (create/update content, search web, check weather, calendar)
- Daily Briefing — Scheduled digest of tasks, calendar, weather, and RSS; interactive follow-up conversation
- Knowledge Graph — D3 force-directed graph of all notes and tags
- Sharing — Share projects and notes with users or groups at viewer/editor/admin permissions
- Fable MCP — MCP server for Claude and other clients to read/write your data via API keys
- PWA — Installable, push notifications, web and Android companion app
Quick Start
Prerequisites: Docker and Docker Compose. 8 GB+ RAM recommended for LLM inference.
git clone https://git.fabledsword.com/bvandeusen/FabledAssistant.git
cd FabledAssistant
cp .env.example .env # Edit .env to set SECRET_KEY
docker compose up --build
Open http://localhost:5000. The first user to register becomes admin.
Go to Settings → General to pull an LLM model. qwen3:8b or llama3.1:8b are good starting points.
Documentation
| Doc | Contents |
|---|---|
| Architecture | Stack, design decisions, data models, key services |
| Configuration | Environment variables, Docker Compose, production setup, security |
| Features | Detailed feature breakdown and keyboard shortcuts |
| Development | Dev workflow, CI/CD, migrations, release process |
| API Keys & MCP | API key management and Fable MCP install guide |
| SSO / OAuth | OIDC setup for Authentik, Keycloak, and other providers |
| API Reference | All REST API endpoints |
| Android App | Flutter companion app architecture and feature status |
License
This project is privately maintained.