ricoeur 0.1.1__tar.gz

ricoeur-0.1.1/.gitignore

@@ -0,0 +1,13 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# Project specific
+.claude/

ricoeur-0.1.1/.python-version

@@ -0,0 +1 @@
+3.10

ricoeur-0.1.1/PKG-INFO

@@ -0,0 +1,178 @@
+Metadata-Version: 2.4
+Name: ricoeur
+Version: 0.1.1
+Summary: A local-first archive, search, and intelligence engine for your LLM conversation history.
+Requires-Python: >=3.10
+Requires-Dist: click>=8.1
+Requires-Dist: rich>=13.0
+Requires-Dist: tomli-w>=1.0
+Requires-Dist: tomli>=2.0; python_version < '3.11'
+Provides-Extra: all
+Requires-Dist: bertopic>=0.16; extra == 'all'
+Requires-Dist: duckdb>=0.10; extra == 'all'
+Requires-Dist: fastapi>=0.110; extra == 'all'
+Requires-Dist: fasttext-wheel>=0.9; extra == 'all'
+Requires-Dist: mcp>=1.0; extra == 'all'
+Requires-Dist: numpy>=1.24; extra == 'all'
+Requires-Dist: pyarrow>=14.0; extra == 'all'
+Requires-Dist: sentence-transformers>=2.2; extra == 'all'
+Requires-Dist: textual>=0.40; extra == 'all'
+Requires-Dist: uvicorn>=0.27; extra == 'all'
+Provides-Extra: analytics
+Requires-Dist: duckdb>=0.10; extra == 'analytics'
+Requires-Dist: pyarrow>=14.0; extra == 'analytics'
+Provides-Extra: embeddings
+Requires-Dist: numpy>=1.24; extra == 'embeddings'
+Requires-Dist: sentence-transformers>=2.2; extra == 'embeddings'
+Provides-Extra: langdetect
+Requires-Dist: fasttext-wheel>=0.9; extra == 'langdetect'
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0; extra == 'mcp'
+Provides-Extra: serve
+Requires-Dist: fastapi>=0.110; extra == 'serve'
+Requires-Dist: uvicorn>=0.27; extra == 'serve'
+Provides-Extra: topics
+Requires-Dist: bertopic>=0.16; extra == 'topics'
+Requires-Dist: numpy>=1.24; extra == 'topics'
+Provides-Extra: tui
+Requires-Dist: textual>=0.40; extra == 'tui'
+Description-Content-Type: text/markdown
+
+# ricoeur
+
+**A local-first archive, search, and intelligence engine for your LLM conversation history.**
+
+*Named after Paul Ricoeur, whose work on narrative identity argued that we understand ourselves through the stories we construct from our lived experience. ricoeur reconstructs the narrative of your intellectual life from thousands of AI conversations.*
+
+## Quickstart
+
+```bash
+# Install with uv
+uv sync
+
+# Initialize the database
+uv run ricoeur init
+
+# Import your ChatGPT export
+uv run ricoeur import chatgpt ~/Downloads/chatgpt-export/conversations.json
+
+# Import your Claude export
+uv run ricoeur import claude ~/Downloads/claude-export/conversations.json
+
+# See what you've got
+uv run ricoeur stats
+
+# Search your history
+uv run ricoeur search "thermal simulation"
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `ricoeur init` | Initialize database and config at `~/.ricoeur/` |
+| `ricoeur import chatgpt <path>` | Import from ChatGPT export (.json or .zip) |
+| `ricoeur import claude <path>` | Import from Claude export (.json or .zip) |
+| `ricoeur search <query>` | Full-text search across all conversations |
+| `ricoeur show <id>` | Display a conversation with formatting |
+| `ricoeur stats` | Analytics dashboard |
+| `ricoeur config show` | Print current configuration |
+| `ricoeur config set <key> <value>` | Update a config value |
+
+## Search
+
+```bash
+# Basic full-text search
+ricoeur search "streamlit dashboard"
+
+# Filter by platform, language, date
+ricoeur search "error fix" --platform chatgpt --lang en
+ricoeur search "strategie marketing" --lang fr --since 2025-01-01
+
+# Search only in code blocks
+ricoeur search "import pandas" --code
+
+# Output formats: table (default), json, full, ids
+ricoeur search "MCP" --format json
+```
+
+## Import options
+
+```bash
+# Re-import safely (updates existing, adds new, never deletes)
+ricoeur import chatgpt conversations.json --update
+
+# Dry run — parse and validate without writing
+ricoeur import chatgpt conversations.json --dry-run
+
+# Only import recent conversations
+ricoeur import claude conversations.json --since 2025-01-01
+```
+
+## Optional extras
+
+Install additional capabilities as needed:
+
+```bash
+# Semantic search with sentence-transformers
+uv sync --extra embeddings
+
+# Topic modeling with BERTopic
+uv sync --extra topics
+
+# Analytics with DuckDB + Parquet
+uv sync --extra analytics
+
+# Terminal UI
+uv sync --extra tui
+
+# MCP server for Claude Desktop
+uv sync --extra mcp
+
+# Web API server
+uv sync --extra serve
+
+# Everything
+uv sync --extra all
+```
+
+## Configuration
+
+Config lives at `~/.ricoeur/config.toml`:
+
+```toml
+[general]
+home = "~/.ricoeur"
+default_language = "en"
+
+[embeddings]
+model = "st:paraphrase-multilingual-mpnet-base-v2"
+batch_size = 64
+device = "auto"
+
+[topics]
+min_cluster_size = 15
+n_topics = "auto"
+
+[summarize]
+enabled = false
+model = "ollama:llama3.2"
+```
+
+Override the data directory with the `RICOEUR_HOME` environment variable.
+
+## Architecture
+
+```
+~/.ricoeur/
+├── config.toml          # Configuration
+├── ricoeur.db           # SQLite database (FTS5 search)
+├── analytics/           # Parquet files for DuckDB
+├── embeddings/          # Sentence-transformer vectors
+├── models/              # Saved BERTopic models
+└── attachments/         # Extracted files
+```
+
+## License
+
+MIT

ricoeur-0.1.1/README.md

@@ -0,0 +1,138 @@
+# ricoeur
+
+**A local-first archive, search, and intelligence engine for your LLM conversation history.**
+
+*Named after Paul Ricoeur, whose work on narrative identity argued that we understand ourselves through the stories we construct from our lived experience. ricoeur reconstructs the narrative of your intellectual life from thousands of AI conversations.*
+
+## Quickstart
+
+```bash
+# Install with uv
+uv sync
+
+# Initialize the database
+uv run ricoeur init
+
+# Import your ChatGPT export
+uv run ricoeur import chatgpt ~/Downloads/chatgpt-export/conversations.json
+
+# Import your Claude export
+uv run ricoeur import claude ~/Downloads/claude-export/conversations.json
+
+# See what you've got
+uv run ricoeur stats
+
+# Search your history
+uv run ricoeur search "thermal simulation"
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `ricoeur init` | Initialize database and config at `~/.ricoeur/` |
+| `ricoeur import chatgpt <path>` | Import from ChatGPT export (.json or .zip) |
+| `ricoeur import claude <path>` | Import from Claude export (.json or .zip) |
+| `ricoeur search <query>` | Full-text search across all conversations |
+| `ricoeur show <id>` | Display a conversation with formatting |
+| `ricoeur stats` | Analytics dashboard |
+| `ricoeur config show` | Print current configuration |
+| `ricoeur config set <key> <value>` | Update a config value |
+
+## Search
+
+```bash
+# Basic full-text search
+ricoeur search "streamlit dashboard"
+
+# Filter by platform, language, date
+ricoeur search "error fix" --platform chatgpt --lang en
+ricoeur search "strategie marketing" --lang fr --since 2025-01-01
+
+# Search only in code blocks
+ricoeur search "import pandas" --code
+
+# Output formats: table (default), json, full, ids
+ricoeur search "MCP" --format json
+```
+
+## Import options
+
+```bash
+# Re-import safely (updates existing, adds new, never deletes)
+ricoeur import chatgpt conversations.json --update
+
+# Dry run — parse and validate without writing
+ricoeur import chatgpt conversations.json --dry-run
+
+# Only import recent conversations
+ricoeur import claude conversations.json --since 2025-01-01
+```
+
+## Optional extras
+
+Install additional capabilities as needed:
+
+```bash
+# Semantic search with sentence-transformers
+uv sync --extra embeddings
+
+# Topic modeling with BERTopic
+uv sync --extra topics
+
+# Analytics with DuckDB + Parquet
+uv sync --extra analytics
+
+# Terminal UI
+uv sync --extra tui
+
+# MCP server for Claude Desktop
+uv sync --extra mcp
+
+# Web API server
+uv sync --extra serve
+
+# Everything
+uv sync --extra all
+```
+
+## Configuration
+
+Config lives at `~/.ricoeur/config.toml`:
+
+```toml
+[general]
+home = "~/.ricoeur"
+default_language = "en"
+
+[embeddings]
+model = "st:paraphrase-multilingual-mpnet-base-v2"
+batch_size = 64
+device = "auto"
+
+[topics]
+min_cluster_size = 15
+n_topics = "auto"
+
+[summarize]
+enabled = false
+model = "ollama:llama3.2"
+```
+
+Override the data directory with the `RICOEUR_HOME` environment variable.
+
+## Architecture
+
+```
+~/.ricoeur/
+├── config.toml          # Configuration
+├── ricoeur.db           # SQLite database (FTS5 search)
+├── analytics/           # Parquet files for DuckDB
+├── embeddings/          # Sentence-transformer vectors
+├── models/              # Saved BERTopic models
+└── attachments/         # Extracted files
+```
+
+## License
+
+MIT

ricoeur-0.1.1/pyproject.toml

@@ -0,0 +1,52 @@
+[project]
+name = "ricoeur"
+version = "0.1.1"
+description = "A local-first archive, search, and intelligence engine for your LLM conversation history."
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "click>=8.1",
+    "rich>=13.0",
+    "tomli>=2.0; python_version < '3.11'",
+    "tomli-w>=1.0",
+]
+
+[project.optional-dependencies]
+embeddings = [
+    "sentence-transformers>=2.2",
+    "numpy>=1.24",
+]
+topics = [
+    "bertopic>=0.16",
+    "numpy>=1.24",
+]
+analytics = [
+    "duckdb>=0.10",
+    "pyarrow>=14.0",
+]
+tui = [
+    "textual>=0.40",
+]
+mcp = [
+    "mcp>=1.0",
+]
+serve = [
+    "fastapi>=0.110",
+    "uvicorn>=0.27",
+]
+langdetect = [
+    "fasttext-wheel>=0.9",
+]
+all = [
+    "ricoeur[embeddings,topics,analytics,tui,mcp,serve,langdetect]",
+]
+
+[project.scripts]
+ricoeur = "ricoeur.cli:cli"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/ricoeur"]