memex-claw 0.2.1__tar.gz

memex_claw-0.2.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Corey Thompson
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OF OTHER DEALINGS IN THE
+SOFTWARE.

memex_claw-0.2.1/PKG-INFO

@@ -0,0 +1,57 @@
+Metadata-Version: 2.4
+Name: memex-claw
+Version: 0.2.1
+Summary: Personal AI partner with persistent intent tracking
+Requires-Python: >=3.10
+License-File: LICENSE
+Requires-Dist: pydantic>=2.0
+Requires-Dist: litellm!=1.82.7,!=1.82.8,>=1.0
+Requires-Dist: mcp>=1.0
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: httpx>=0.27
+Requires-Dist: croniter>=2.0
+Requires-Dist: numpy>=1.24
+Requires-Dist: psutil>=5.9
+Requires-Dist: tomli>=2.0; python_version < "3.11"
+Requires-Dist: fathomdb>=0.2.5
+Requires-Dist: pandas>=2.0
+Requires-Dist: textual>=0.40
+Requires-Dist: python-telegram-bot[job-queue]>=22.0
+Requires-Dist: feedparser>=6.0
+Requires-Dist: trafilatura>=1.6
+Requires-Dist: markdownify>=0.14
+Requires-Dist: dateparser>=1.2
+Requires-Dist: curl-cffi>=0.7
+Requires-Dist: yt-dlp>=2024.0
+Requires-Dist: real_ladybug>=0.15.0
+Provides-Extra: embeddings
+Requires-Dist: sentence-transformers>=2.0; extra == "embeddings"
+Provides-Extra: ner
+Requires-Dist: spacy>=3.7.0; extra == "ner"
+Provides-Extra: transcription
+Requires-Dist: nvidia-riva-client>=2.17; extra == "transcription"
+Requires-Dist: openai-whisper>=20231117; extra == "transcription"
+Provides-Extra: audio
+Requires-Dist: sounddevice>=0.4; extra == "audio"
+Requires-Dist: soundfile>=0.12; extra == "audio"
+Requires-Dist: scipy>=1.10; extra == "audio"
+Provides-Extra: diarization
+Requires-Dist: pyannote.audio>=3.1; extra == "diarization"
+Provides-Extra: google
+Requires-Dist: google-auth>=2.0; extra == "google"
+Requires-Dist: google-auth-httplib2>=0.2; extra == "google"
+Requires-Dist: google-auth-oauthlib>=1.0; extra == "google"
+Requires-Dist: google-api-python-client>=2.0; extra == "google"
+Requires-Dist: gkeepapi>=0.14; extra == "google"
+Requires-Dist: msal>=1.0; extra == "google"
+Requires-Dist: caldav>=1.0; extra == "google"
+Provides-Extra: full
+Requires-Dist: memex-claw[audio,diarization,embeddings,google,ner,transcription]; extra == "full"
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+Requires-Dist: pytest-mock; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Dynamic: license-file

memex_claw-0.2.1/README.md

@@ -0,0 +1,141 @@
+# Memex
+
+[![CI](https://github.com/coreyt/memex/actions/workflows/ci.yml/badge.svg)](https://github.com/coreyt/memex/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+Personal AI partner with persistent intent tracking, knowledge management, and multi-interface operation. Memex is a thinking partner, not a chatbot -- it tracks your goals across conversations, remembers what matters, connects ideas, and proactively surfaces relevant context.
+
+## Quick Start
+
+```bash
+# Clone and install (all dependencies are in the main package)
+git clone https://github.com/coreyt/memex.git
+cd memex
+uv pip install -e .
+
+# Initialize and configure
+memex init
+memex setup                            # Interactive provider setup wizard
+
+# Set your LLM API key in .env
+#   ANTHROPIC_API_KEY=sk-ant-...
+#   or OPENAI_API_KEY / GOOGLE_AISTUDIO_API_KEY
+
+# Option A: Full setup (recommended)
+memex service                          # Start daemon (scheduler, Telegram, HTTP gateway on :8321)
+memex tui                              # Open TUI (connects to daemon)
+
+# Option B: Quick standalone chat
+memex chat
+```
+
+> **Note:** `.env` is gitignored. Do not commit it — it's for your local credentials only.
+
+Run `memex doctor` at any time to check system health.
+
+## Runtime-loaded governance files
+
+Four files at the repo root -- `CONSTITUTION.md`, `SOUL.md`, `IDENTITY.md`, and `DOCUMENTATION.md` -- are loaded at runtime by `src/memex/governance.py` and injected into Memex's system prompt on every turn. They govern agent behavior, personality, identity, and internal documentation routing respectively. They are runtime infrastructure, not human-facing documentation; if you are just trying to use or understand Memex, you can skip them. Contributors who want to see how they are wired should start with the loader in `src/memex/governance.py`.
+
+## What Memex Does
+
+- **Thinking-partner conversations** -- each turn runs a classify, retrieve, respond, reflect loop that advances goals and updates persistent state
+- **Goal and intent tracking** -- hierarchical goals, tasks, commitments, execution state, and plan snapshots that persist across sessions
+- **Knowledge capture** -- ingest from files, URLs, stdin, Gmail, RSS feeds, watch folders, YouTube transcripts, and conversations
+- **Hybrid search and retrieval** -- full-text + semantic search with temporal decay, source reputation scoring, and token-budgeted context injection
+- **Meeting intelligence** -- recording, audio preparation, Whisper transcription with quality scoring and retry, speaker diarization, and action extraction
+- **Proactive scheduling** -- 13 built-in scheduled tasks covering briefings, reviews, backups, cleanup, calendar sync, and memory consolidation
+- **18 built-in tools** -- search, ingest, remember, forget, diagnostics, self-repair, cost reporting, and more
+- **Self-improvement** -- behavioral observations, config tuning proposals, and capability proposals (all human-gated)
+- **Episodic memory** -- cross-session event ledger with session briefs, fact extraction, memory consolidation, and cold storage archival
+
+See [dev/FEATURES.md](dev/FEATURES.md) for the complete capability inventory.
+
+## Architecture at a Glance
+
+Every conversation turn executes a three-phase LLM pipeline:
+
+```
+Classify (cheap model) --> Respond (full model with tools) --> Reflect (cheap model)
+```
+
+Classification determines intent and retrieval budget. The response phase retrieves relevant knowledge, selects tools, and generates a reply. Reflection updates goals, extracts facts, and detects behavioral patterns.
+
+**Two-process model**: `memex service` runs the daemon (Telegram polling, cron scheduler, HTTP/SSE gateway on port 8321). `memex tui` is a thin client that connects over HTTP/SSE. `memex chat` works standalone without the daemon.
+
+**Storage**: SQLite is the primary store (WAL mode). LadybugDB provides a derived retrieval layer with graph, vector, and full-text search. Embeddings use sentence-transformers locally; Qdrant is an optional server-side backend.
+
+**Unified API**: All interfaces (CLI, TUI, Telegram, MCP) route through `MemexAPI` for consistent caller identity, format injection, and session handling.
+
+See [ARCHITECTURE.md](ARCHITECTURE.md) for the full design.
+
+## Interfaces
+
+| Interface | Description |
+|-----------|-------------|
+| **CLI** | `memex chat`, `memex goal`, `memex search`, `memex ingest`, and 20+ other commands |
+| **TUI** | Three-panel Textual interface (goals, chat, notifications) connecting to the service daemon |
+| **Telegram** | Bot with user-ID auth, message batching, URL ingestion; managed by `memex service` |
+| **MCP Server** | `memex serve` exposes scoped tool sets (`read_only`, `collaborative`, `full`) for external agents |
+| **HTTP Gateway** | REST + SSE on port 8321, provided by `memex service` for TUI and automation |
+
+See [docs/](docs/) for interface-specific guides: [TUI Guide](docs/tui-guide.md), [CLI Reference](docs/cli-reference.md), [Integrations](docs/integrations.md).
+
+## Documentation
+
+| Document | Contents |
+|----------|----------|
+| [docs/getting-started.md](docs/getting-started.md) | Installation, first run, initial configuration |
+| [docs/cli-reference.md](docs/cli-reference.md) | All CLI commands and flags |
+| [docs/tui-guide.md](docs/tui-guide.md) | TUI layout, keybindings, service connection |
+| [docs/meetings.md](docs/meetings.md) | Recording, transcription, diarization, action extraction |
+| [docs/knowledge.md](docs/knowledge.md) | Ingestion, search, retrieval, decay, reputation |
+| [docs/scheduling.md](docs/scheduling.md) | Scheduler, built-in tasks, work queue |
+| [docs/integrations.md](docs/integrations.md) | Gmail, Google Calendar, iCloud, Outlook, Claude Code, MCP |
+| [docs/configuration.md](docs/configuration.md) | Environment variables, LLM providers, vector backends |
+| [ARCHITECTURE.md](ARCHITECTURE.md) | System design, component map, trade-offs |
+| [dev/FEATURES.md](dev/FEATURES.md) | Complete feature inventory |
+
+## Configuration
+
+Key environment variables (set in `.env`):
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `ANTHROPIC_API_KEY` | -- | Anthropic API key (or `OPENAI_API_KEY`, `GOOGLE_AISTUDIO_API_KEY`) |
+| `MEMEX_RESPONSE_MODEL` | `anthropic/claude-sonnet-4-20250514` | LLM for main responses |
+| `MEMEX_CHEAP_MODEL` | `anthropic/claude-haiku-4-5-20251001` | LLM for classify/reflect |
+| `MEMEX_STORE` | `.memex/memex.db` | SQLite database path |
+| `TELEGRAM_BOT_TOKEN` | -- | Telegram bot token (enables Telegram in `memex service`) |
+| `TELEGRAM_USER_ID` | -- | Comma-separated allowed Telegram user IDs |
+
+See [docs/configuration.md](docs/configuration.md) for the full variable reference including LLM proxy, connectors, vector search, meetings, and integration credentials.
+
+## Development
+
+```bash
+# Install dev dependencies
+uv sync
+
+# Run tests
+uv run pytest tests/ -q
+
+# Run the operability gate (startup, doctor, API, scheduler, Telegram, CLI regression)
+source .env && uv run memex-operability
+
+# Lint
+uv run ruff check src/ tests/
+```
+
+### Optional Extras
+
+All core features are included in the base install. Optional extras:
+
+```bash
+uv pip install -e ".[diarization]"     # Speaker diarization (pyannote.audio; requires HF token)
+uv pip install -e ".[dev]"             # Testing and development tools
+```
+
+## License
+
+MIT

memex_claw-0.2.1/pyproject.toml

@@ -0,0 +1,104 @@
+[build-system]
+requires = ["setuptools>=68.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "memex-claw"
+version = "0.2.1"
+description = "Personal AI partner with persistent intent tracking"
+requires-python = ">=3.10"
+dependencies = [
+    # Core runtime
+    "pydantic>=2.0",
+    "litellm>=1.0,!=1.82.7,!=1.82.8",
+    "mcp>=1.0",
+    "python-dotenv>=1.0",
+    "httpx>=0.27",
+    "croniter>=2.0",
+    "numpy>=1.24",
+    "psutil>=5.9",
+    "tomli>=2.0; python_version < '3.11'",
+    # Storage
+    "fathomdb>=0.2.5",
+    "pandas>=2.0",
+    # Interfaces
+    "textual>=0.40",
+    "python-telegram-bot[job-queue]>=22.0",
+    # Web / content ingest
+    "feedparser>=6.0",
+    "trafilatura>=1.6",
+    "markdownify>=0.14",
+    "dateparser>=1.2",
+    "curl-cffi>=0.7",
+    "yt-dlp>=2024.0",
+    "real_ladybug>=0.15.0",
+]
+
+[tool.uv]
+# onnxruntime >=1.24 dropped aarch64 cp310 wheels; cap for Jetson compatibility
+constraint-dependencies = ["onnxruntime<1.24"]
+
+[project.optional-dependencies]
+embeddings = ["sentence-transformers>=2.0"]
+ner = [
+    "spacy>=3.7.0",
+    # After install, run: python -m spacy download en_core_web_sm
+]
+transcription = [
+    "nvidia-riva-client>=2.17",
+    "openai-whisper>=20231117",
+]
+audio = ["sounddevice>=0.4", "soundfile>=0.12", "scipy>=1.10"]
+diarization = ["pyannote.audio>=3.1"]
+google = [
+    "google-auth>=2.0",
+    "google-auth-httplib2>=0.2",
+    "google-auth-oauthlib>=1.0",
+    "google-api-python-client>=2.0",
+    "gkeepapi>=0.14",
+    "msal>=1.0",
+    "caldav>=1.0",
+]
+full = ["memex-claw[embeddings,ner,transcription,audio,diarization,google]"]
+dev = [
+    "pytest",
+    "pytest-asyncio",
+    "pytest-mock",
+    "pytest-cov",
+    "ruff",
+    "mypy",
+]
+
+[dependency-groups]
+dev = [
+    "pytest>=7.0",
+    "pytest-asyncio>=0.23",
+    "pytest-mock>=3.10",
+    "pytest-cov>=4.0",
+    "ruff>=0.1",
+    "mypy>=1.0",
+    "bandit>=1.9.4",
+    "detect-secrets>=1.4",
+]
+
+[project.scripts]
+memex = "memex.cli:main"
+memex-mcp = "memex.interfaces.mcp_server:main"
+memex-operability = "memex.operability_gate:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+
+[tool.ruff]
+target-version = "py310"
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+
+[[tool.mypy.overrides]]
+module = ["litellm.*", "mcp.*"]
+ignore_missing_imports = true

memex_claw-0.2.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

memex_claw-0.2.1/src/memex/__init__.py

@@ -0,0 +1,3 @@
+"""Memex: Personal AI partner with persistent intent tracking."""
+
+__version__ = "0.1.0"