bvandeusen
e2133529a0
- docs/api-reference.md: complete REST API endpoint reference (~60+ routes) - docs/android-app.md: Flutter companion app stack, architecture, feature status - docs/architecture.md: detailed file-by-file reference for all backend services and frontend components - docs/features.md: LLM pipeline internals (intent routing, tool loop, duplicate guards, image search, research pipeline), roadmap - docs/development.md: full migration chain (0001–0026) with naming and caveats - README.md: link to new api-reference and android-app docs Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
49 lines
2.4 KiB
Markdown
49 lines
2.4 KiB
Markdown
# 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.
|
|
|
|
```bash
|
|
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](docs/architecture.md) | Stack, design decisions, data models, key services |
|
|
| [Configuration](docs/configuration.md) | Environment variables, Docker Compose, production setup, security |
|
|
| [Features](docs/features.md) | Detailed feature breakdown and keyboard shortcuts |
|
|
| [Development](docs/development.md) | Dev workflow, CI/CD, migrations, release process |
|
|
| [API Keys & MCP](docs/api-keys-and-mcp.md) | API key management and Fable MCP install guide |
|
|
| [SSO / OAuth](docs/sso-oauth.md) | OIDC setup for Authentik, Keycloak, and other providers |
|
|
| [API Reference](docs/api-reference.md) | All REST API endpoints |
|
|
| [Android App](docs/android-app.md) | Flutter companion app architecture and feature status |
|
|
| [Changelog](docs/changelog.md) | Development history |
|
|
|
|
## License
|
|
|
|
This project is privately maintained.
|