local.example.yaml
yaml
sha256:8915fe406161f95c1681f9469375e7bae5b28c884f00bedbdef65e4b0cd0738d
docs(flow): commit FLOW-V0-SPEC.md hygiene for 7A-INT merge
Human
18 hours ago
| 1 | # Copy to config/local.yaml and set your paths. Do not commit config/local.yaml. |
| 2 | # Full schema: docs/SPEC.md §4.4. Use env for secrets (e.g. OPENAI_API_KEY). |
| 3 | |
| 4 | # --- Required --- |
| 5 | # Absolute path to the vault (Obsidian-style Markdown root) |
| 6 | # vault_path: /absolute/path/to/knowtation/vault |
| 7 | # Or env: KNOWTATION_VAULT_PATH |
| 8 | |
| 9 | # --- Vector store (one of) --- |
| 10 | # Qdrant: requires a running Qdrant server. Use for multi-process or scale. |
| 11 | # qdrant_url: http://localhost:6333 |
| 12 | # Or env: QDRANT_URL |
| 13 | # vector_store: qdrant |
| 14 | # |
| 15 | # sqlite-vec: no separate server; DB under data_dir. Use for single-machine, simple setup. |
| 16 | # vector_store: sqlite-vec |
| 17 | # data_dir: data/ # env KNOWTATION_DATA_DIR; DB file: data/knowtation_vectors.db |
| 18 | # Or env: KNOWTATION_VECTOR_STORE=sqlite-vec |
| 19 | |
| 20 | # --- Embedding (indexer and search) --- |
| 21 | # embedding: |
| 22 | # provider: ollama |
| 23 | # model: nomic-embed-text |
| 24 | # # ollama_url: http://localhost:11434 # optional override |
| 25 | # Or env: OLLAMA_URL (overrides ollama_url in file when set; same as hub bridge) |
| 26 | # For OpenAI: set OPENAI_API_KEY in env and use provider: openai, model: text-embedding-3-small |
| 27 | # For Voyage (cloud vectors, non-OpenAI): set VOYAGE_API_KEY and provider: voyage, model: voyage-4-lite |
| 28 | # Env overrides: EMBEDDING_PROVIDER=ollama|openai|voyage EMBEDDING_MODEL=... (same as hosted bridge) |
| 29 | |
| 30 | # --- Indexer chunking (optional) --- |
| 31 | # indexer: |
| 32 | # chunk_size: 2048 # chars (~512 tokens); overlap below |
| 33 | # chunk_overlap: 256 |
| 34 | |
| 35 | # --- Transcription (audio/video import) --- |
| 36 | # transcription: |
| 37 | # provider: openai |
| 38 | # model: whisper-1 |
| 39 | # # When a file is over OpenAI's ~25MB limit, self-hosted Hub/CLI can auto-compress via ffmpeg (if installed on PATH or FFMPEG_PATH). |
| 40 | # transcode_oversized: true # default true; set false to skip ffmpeg and fail fast on oversized files |
| 41 | # Requires OPENAI_API_KEY in env. Optional: KNOWTATION_TRANSCODE_OVERSIZED=0 to disable transcode via env. |
| 42 | # Get key: platform.openai.com → API Keys. New accounts get $5 free credits; Whisper ~$0.006/min. |
| 43 | # ffmpeg: https://ffmpeg.org/download.html — Docker Hub image includes ffmpeg when built from hub/Dockerfile. |
| 44 | |
| 45 | # --- Optional: memory layer (timestamped event log, semantic recall) --- |
| 46 | # memory: |
| 47 | # enabled: true |
| 48 | # provider: file # file | vector | mem0 | supabase |
| 49 | # # url: http://localhost:8080 # for Mem0 provider; env KNOWTATION_MEMORY_URL |
| 50 | # # retention_days: 90 # null = keep forever; number = auto-prune |
| 51 | # # scope: vault # vault (per-vault, default) | global (shared across all vaults) |
| 52 | # # encrypt: false # true = AES-256-GCM at rest; requires secret or KNOWTATION_MEMORY_SECRET |
| 53 | # # secret: "" # encryption key; prefer env KNOWTATION_MEMORY_SECRET over YAML |
| 54 | # # supabase_url: "" # for Supabase provider; env KNOWTATION_SUPABASE_URL |
| 55 | # # supabase_key: "" # for Supabase provider; env KNOWTATION_SUPABASE_KEY |
| 56 | # # capture: # which events to auto-capture (defaults below) |
| 57 | # # - search |
| 58 | # # - export |
| 59 | # # - write |
| 60 | # # - import |
| 61 | # # - index |
| 62 | # # - propose |
| 63 | # # # opt-in: agent_interaction, capture, error, session_summary |
| 64 | |
| 65 | # --- Optional: AIR attestation (before write non-inbox, before export) --- |
| 66 | # air: |
| 67 | # enabled: false |
| 68 | # endpoint: http://localhost:3000 |
| 69 | # Or env: KNOWTATION_AIR_ENDPOINT |
| 70 | |
| 71 | # --- Vault Git (optional backup / versioning) --- |
| 72 | # vault: |
| 73 | # git: |
| 74 | # enabled: true |
| 75 | # remote: https://github.com/you/your-vault-repo.git |
| 76 | # auto_commit: false # set true to auto-commit after Hub write/capture/approve (and CLI write if using Hub) |
| 77 | # auto_push: false # set true to push after each auto-commit (requires remote) |
| 78 | # Proposals stay Hub-only; Git is for the vault content. See PROVENANCE-AND-GIT.md. |
| 79 | |
| 80 | # --- MCP Streamable HTTP (optional; default is stdio) --- |
| 81 | # mcp: |
| 82 | # http_port: 3334 |
| 83 | # http_host: 127.0.0.1 # use 0.0.0.0 only with auth / firewall; see docs/MCP-PHASE-D.md |
| 84 | # Or env: KNOWTATION_MCP_HTTP_PORT, MCP_TRANSPORT=http |
| 85 | |
| 86 | # --- Reserved: Phase 12 (blockchain / agent payments) --- |
| 87 | # Future config may add blockchain or payment-related keys. No keys in current schema. |
File History
1 commit
sha256:8915fe406161f95c1681f9469375e7bae5b28c884f00bedbdef65e4b0cd0738d
docs(flow): commit FLOW-V0-SPEC.md hygiene for 7A-INT merge
Human
18 hours ago