eidetic-os 4.0.0__tar.gz

eidetic_os-4.0.0/.env.example

@@ -0,0 +1,125 @@
+# ──────────────────────────────────────────────────────────────────────────────
+# Eidetic OS configuration
+#
+# Copy this file to `.env` and fill in your own values:
+#     cp .env.example .env
+#
+# Load it into your shell before running scripts:
+#     set -a; source .env; set +a
+#
+# `.env` is git-ignored. NEVER commit real secrets. All values below are
+# placeholders / safe defaults — none are real credentials.
+# ──────────────────────────────────────────────────────────────────────────────
+
+# ── Vault ───────────────────────────────────────────────────────────────────
+# Absolute path to your markdown vault. Required by almost every script.
+VAULT_PATH=~/Documents/Obsidian/MyVault
+
+# Where to write the RAG vector store and graph (default: $VAULT_PATH/.rag)
+# The vector store is a SQLite database ($RAG_DIR/vectors.db). Install the
+# optional [vector] extra (sqlite-vec + numpy) to accelerate similarity search;
+# without it the store falls back to a pure-Python cosine scan automatically.
+# RAG_DIR=~/Documents/Obsidian/MyVault/.rag
+
+# Force the brute-force cosine backend even when sqlite-vec is installed
+# (testing, or opting out of the native extension). Leave unset for normal use.
+# EIDETIC_VECTORDB_NO_VEC=1
+
+# Pluggable vector-storage backend (default: sqlite). Swap in an alternative
+# engine for larger or more demanding indexes, then migrate your existing store
+# with `eidetic migrate-vectors --to <backend>`:
+#   sqlite  — zero-config default, no extra dependencies.
+#   lancedb — columnar, on-disk, zero-copy scans (pip install 'eidetic-os[lancedb]').
+#   chroma  — popular embedding database     (pip install 'eidetic-os[chroma]').
+# VECTOR_BACKEND=sqlite
+
+# Where your Claude scheduled-task SKILL.md folders live
+# SCHEDULED_DIR=~/Documents/Claude/Scheduled
+
+# Where `eidetic skills install <name>` writes installed skills
+# (default: $VAULT_PATH/.claude/skills)
+# EIDETIC_SKILLS_DIR=~/Documents/Claude/Scheduled
+
+# Where `eidetic session` reads Cowork chat transcripts from
+# (default: ~/Library/Application Support/Claude/local-agent-mode-sessions on macOS)
+# CLAUDE_SESSIONS_DIR=~/Library/Application Support/Claude/local-agent-mode-sessions
+
+# How often the Cowork session-capture skills run. This is a scheduling hint —
+# you wire the actual cron/skill cadence to match it; the value documents intent
+# and is read by setup tooling. One of:
+#   twice   (default) morning + afternoon captures, each `--since 12h`
+#   daily             one nightly capture, `--since 24h`
+#   hourly            every hour, for heavy users (`--since 1h` or watermark)
+#   manual            no schedule — only when you run `eidetic session save`
+# SESSION_CAPTURE_FREQUENCY=twice
+
+# ── Pluggable LLM backends (auto-detected) ───────────────────────────────────
+# Eidetic OS talks to any OpenAI-compatible LLM server. If you leave the EMBED_*
+# and LM_STUDIO_* vars below unset, it auto-detects a running backend by probing
+# (in order): LM Studio → Ollama → llama.cpp → a custom OpenAI-compatible URL.
+# Run `eidetic backends` to see what's detected, `eidetic backends test` to verify.
+#
+#   EIDETIC_LLM_BACKEND   force one backend, skipping detection:
+#                       lmstudio | ollama | llamacpp | openai-compatible
+#   EIDETIC_LLM_MODEL     override the chat model name reported to callers
+# EIDETIC_LLM_BACKEND=
+# EIDETIC_LLM_MODEL=
+#
+# Per-backend base URL overrides (only needed if not on the default localhost port):
+#   LM_STUDIO_URL (default :5555) · OLLAMA_URL (default :11434)
+#   LLAMACPP_URL (default :8080)  · OPENAI_COMPATIBLE_URL (no default — must be set)
+# OLLAMA_URL=http://localhost:11434
+# LLAMACPP_URL=http://localhost:8080
+# OPENAI_COMPATIBLE_URL=
+
+# ── Local LLM: embeddings (OpenAI-compatible, e.g. LM Studio / Ollama) ───────
+# Explicit values here take precedence over backend auto-detection above.
+EMBED_HOST=localhost
+EMBED_PORT=5555
+EMBED_MODEL=text-embedding-nomic-embed-text-v1.5
+# EMBED_API_KEY=                 # only if your endpoint requires a bearer token
+# EMBED_URL=                     # overrides host/port if set
+
+# ── Local LLM: chat completions (used by trading module) ─────────────────────
+LM_STUDIO_HOST=localhost
+LM_STUDIO_PORT=5555
+LM_STUDIO_MODEL=local-model
+# Two scripts read the chat endpoint and expect DIFFERENT shapes — set whichever
+# you use, or leave both unset to fall back to host/port:
+#   LM_STUDIO_URL       used by scripts/trading_briefing.py — include the /v1 suffix
+#                       default: http://$LM_STUDIO_HOST:$LM_STUDIO_PORT/v1
+#   LM_STUDIO_ENDPOINT  used by trading/config.py + trading/core.py — NO /v1 suffix
+#                       default: http://$LM_STUDIO_HOST:$LM_STUDIO_PORT
+# LM_STUDIO_URL=
+# LM_STUDIO_ENDPOINT=
+
+# ── Text-to-speech (optional) ────────────────────────────────────────────────
+TTS_HOST=localhost
+TTS_PORT=8800
+
+# ── Email (SMTP) ──────────────────────────────────────────────────────────────
+# The account that sends reports/newsletters.
+SENDER_EMAIL=your-eidetic-account@example.com
+SENDER_NAME=Eidetic
+SMTP_SERVER=smtp.gmail.com
+SMTP_PORT=587
+# Gmail app password (https://myaccount.google.com/apppasswords) — NEVER commit
+SMTP_APP_PASSWORD=your-app-password
+
+# Where reports are sent (usually yourself)
+USER_EMAIL=your-email@example.com
+
+# ── Dashboard ports (optional) ────────────────────────────────────────────────
+DASHBOARD_FRONTEND_PORT=3000
+DASHBOARD_BACKEND_PORT=5001
+
+# ── Trading module (optional) ─────────────────────────────────────────────────
+TRADING_AGENTS_PATH=~/Documents/TradingAgents
+TRADING_TICKERS=BTC-USD,ETH-USD
+# Cloud Portfolio Manager step (off by default) — only if you opt in:
+# ANTHROPIC_API_KEY=sk-ant-your-key
+# ANTHROPIC_MODEL=claude-opus-4-6
+
+# ── Git (optional) ────────────────────────────────────────────────────────────
+# If you mirror your vault to a remote, set it here (your private repo).
+# GITHUB_REPO=your-username/your-vault

eidetic_os-4.0.0/.gitignore

@@ -0,0 +1,80 @@
+# ── Secrets & credentials ───────────────────────────────────────────────────
+.env
+.env.*
+!.env.example
+*.key
+*.pem
+*.p12
+credentials*
+*credential*
+*password*
+*secret*
+*.token
+.anthropic-api-key
+*-app-password
+*gmail-app-password*
+
+# ── Personal data / PII (never commit) ──────────────────────────────────────
+*.xlsx          # job trackers and other spreadsheets contain PII
+*.xls
+*.csv           # may contain personal/exported data
+vault-content/
+vault/
+personal/
+private/
+job-search/
+job-tracker*
+briefings/
+*briefing*.md
+session-logs/
+*.eml
+
+# ── Generated RAG / graph data (contains embedded personal notes) ───────────
+*.sqlite
+*.sqlite3
+*.db
+vectors.json
+vectors.json.tmp
+graph.json
+graph.json.tmp
+last_embed.txt
+last_embed_fallback.txt
+embed_checkpoint.json
+.rag/
+.vectors/
+cache/
+
+# ── Trading (local config may contain real paths / keys) ────────────────────
+trading/config.py
+signals.json
+
+# ── Python ──────────────────────────────────────────────────────────────────
+__pycache__/
+*.py[cod]
+*.egg-info/
+.venv/
+venv/
+.env.bak
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# ── Node / dashboard ────────────────────────────────────────────────────────
+node_modules/
+dist/
+build/
+*.log
+
+# ── OS / editor ─────────────────────────────────────────────────────────────
+.DS_Store
+Thumbs.db
+*.swp
+.idea/
+.vscode/
+
+# ── Local Claude Code / agent tooling state (not part of the public repo) ────
+.claude/
+
+# ── Eidetic OS runtime state (created on first run; never part of the repo) ──
+.eidetic/
+.atlas/