Sayou
by pixell-globalcommunityv0.2.2
28
1
Sayou is a file-system inspired context store for AI agents that allows for persistent reasoning and knowledge accumulation over time, replacing traditional databases.
From the registry: Persistent knowledge workspace for AI agents. Versioned files, search, and MCP tools.
Install & configure
Prerequisites
- required
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `sayou` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Python** — Python 3.11+ required. Install via pip. Run: `pip install sayou` (https://pypi.org/project/sayou/)
Canonical MCP server config (stdio transport):
- command: `sayou`
- args: []
Note: File-system inspired context store for AI agents. 11 MCP tools: workspace_write/read/list/search/delete/history/glob/grep/kv/links/chunks. Initialize with `sayou init --claude` or `pip install sayou && sayou init`. Fully local by default, optional MySQL+S3 for production.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: File-system inspired context store for AI agents. 11 MCP tools: workspace_write/read/list/search/delete/history/glob/grep/kv/links/chunks. Initialize with `sayou init --claude` or `pip install sayou && sayou init`. Fully local by default, optional MySQL+S3 for production.
Tools (12)
workspace_write
Write or update a file (text or binary with YAML frontmatter)
workspace_read
Read latest or specific version, with optional line range
workspace_list
List files and subfolders with auto-generated index
workspace_search
Search by full-text query, frontmatter filters, or chunk-level
workspace_delete
Soft-delete a file (history preserved)
workspace_history
Version history with timestamps, or diff between two versions
workspace_glob
Find files matching a glob pattern
workspace_grep
Search file contents with context lines
workspace_kv
Key-value store (get/set/list/delete with optional TTL)
workspace_links
File links and knowledge graph (get or add links)
workspace_chunks
Chunk outline or read a specific chunk by index
workspace_semantic_search
Vector similarity search (requires SAYOU_EMBEDDING_PROVIDER)
Environment variables
SAYOU_EMBEDDING_PROVIDERProvider for vector similarity searchOPENAI_API_KEYrequiredAPI key for OpenAI servicesZEP_API_KEYrequiredAPI key for Zep Cloud servicesSAYOU_AGENT_E2B_API_KEYAPI key for executing code in the agentPackages
sayou
pypiv0.2.2transport: stdio
Details
- Language
- Python
- License
- Apache-2.0
- Released
- Feb 22, 2026
- Last commit
- May 5, 2026
- Registry name
- io.github.pixell-global/sayou