# FlowTether

> FlowTether is a sovereign Personal Knowledge Management (PKM) system designed for unfinished thinking. It captures fragments — ideas, notes, decisions, conversations — and connects them over time using semantic search, AI chat, and spatial visualization. EU-hosted, privacy-first, no AI training on user data.

## Product Pages
- [Home](https://flowtether.ai/): Landing page — value proposition, import sources, AI features, privacy architecture
- [Features](https://flowtether.ai/features): Full feature matrix (35+ features) organized by category with status tags
- [About](https://flowtether.ai/about): Mission, philosophy, and how FlowTether works
- [Privacy Policy](https://flowtether.ai/privacy): What is and isn't collected, data ownership, no third-party analytics
- [Terms of Service](https://flowtether.ai/terms): Account responsibilities, content ownership, acceptable use
- [Contact](https://flowtether.ai/contact): Contact form for support, bug reports, feature requests, partnerships
- [Changelog](https://flowtether.ai/changelog): Product updates and release notes

## Developer Resources
- [AI Agents Integration](https://flowtether.ai/agents): MCP integration guide — tools, quick start, API reference
- [MCP Server Download](https://flowtether.ai/downloads/flowtether_mcp.py): Python MCP server script for AI agent integration
- [MCP Requirements](https://flowtether.ai/downloads/mcp_requirements.txt): Python dependencies for the MCP server
- [API Documentation](https://flowtether.ai/llms-full.txt): Full technical documentation in markdown
- [AI Plugin Manifest](https://flowtether.ai/.well-known/ai-plugin.json): Agent framework discovery file

## Core Concepts
- **Pearl**: An atomic knowledge unit — a full document, note, decision, or snippet
- **Buoy**: A topic cluster that groups related Pearls
- **Net**: A visual canvas/workspace for spatial organization
- **Harbor**: A sovereignty boundary — an isolated workspace with its own permissions
- **Strand**: A typed relationship between knowledge items (related_to, builds_on, contradicts, supersedes)
- **SlipStream**: An AI chat conversation with full context of your knowledge
- **Lumi**: The AI librarian that searches, connects, and surfaces your knowledge
- **The Map**: A spatial visualization of your entire knowledge graph

## Integration
- **MCP Protocol**: Model Context Protocol server for AI agent read/write access to harbors
- **API Keys**: `ft_live_` prefixed keys for programmatic access
- **Import Sources**: ChatGPT, Claude, Evernote, Confluence, Notion, Obsidian, Roam Research, documents (PDF/DOCX), Excel, voice recordings
- **Web Clipper**: Browser extension for capturing web content (coming soon)
- **Beacon**: Desktop companion app (in development)

## Technical Details
- **Hosting**: EU-based (Hetzner, Germany)
- **Search**: Hybrid semantic (vector) + full-text search
- **AI**: Local LLM (Qwen3) for privacy-preserving operations, Claude API for managed chat
- **Auth**: JWT sessions + API key authentication
- **Data Format**: JSONB documents with ProseMirror-compatible rich text