nexusmemo 0.1.0__tar.gz

nexusmemo-0.1.0/.env.example

@@ -0,0 +1,30 @@
+# NexusMemory Configuration
+# Copy this file to .env and fill in your values
+
+# --- LLM Provider ---
+# Required: at least one API key
+NEXUSMEMORY_OPENAI_API_KEY=sk-your-openai-key-here
+# NEXUSMEMORY_ANTHROPIC_API_KEY=sk-ant-your-key-here
+
+# Provider: "openai" or "anthropic"
+NEXUSMEMORY_LLM_PROVIDER=openai
+NEXUSMEMORY_EXTRACTION_MODEL=gpt-4o-mini
+
+# --- Embeddings ---
+# Provider: "openai" (default)
+NEXUSMEMORY_EMBEDDING_PROVIDER=openai
+NEXUSMEMORY_EMBEDDING_MODEL=text-embedding-3-small
+NEXUSMEMORY_EMBEDDING_DIMENSIONS=1536
+
+# --- Data ---
+# Where to store the database (default: ~/.nexusmemory)
+# NEXUSMEMORY_DATA_DIR=~/.nexusmemory
+
+# --- Server ---
+NEXUSMEMORY_HOST=127.0.0.1
+NEXUSMEMORY_PORT=8765
+
+# --- Retrieval ---
+NEXUSMEMORY_MAX_RESULTS=10
+NEXUSMEMORY_SIMILARITY_THRESHOLD=0.3
+NEXUSMEMORY_GRAPH_EXPANSION_DEPTH=2

nexusmemo-0.1.0/.gitignore

@@ -0,0 +1,37 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+*.egg
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Environment
+.env
+
+# Database
+*.db
+data/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Testing
+.pytest_cache/
+htmlcov/
+.coverage

nexusmemo-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Byhunny
+
+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 OR OTHER DEALINGS IN THE
+SOFTWARE.

nexusmemo-0.1.0/PKG-INFO

@@ -0,0 +1,177 @@
+Metadata-Version: 2.4
+Name: nexusmemo
+Version: 0.1.0
+Summary: Local-first AI memory layer that gives LLMs persistent, structured memory
+Project-URL: Homepage, https://github.com/Byhunny/nexusmemory
+Project-URL: Repository, https://github.com/Byhunny/nexusmemory
+Project-URL: Issues, https://github.com/Byhunny/nexusmemory/issues
+Author-email: Byhunny <tansusam91@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,knowledge-graph,llm,mcp,memory
+Classifier: Development Status :: 3 - Alpha
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.11
+Requires-Dist: click>=8.1.0
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: mcp[cli]>=1.0.0
+Requires-Dist: networkx>=3.3
+Requires-Dist: numpy>=1.26.0
+Requires-Dist: openai>=1.30.0
+Requires-Dist: pydantic-settings>=2.3.0
+Requires-Dist: pydantic>=2.7.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: sqlalchemy>=2.0.0
+Requires-Dist: uvicorn[standard]>=0.30.0
+Provides-Extra: anthropic
+Requires-Dist: anthropic>=0.30.0; extra == 'anthropic'
+Provides-Extra: dev
+Requires-Dist: httpx>=0.27; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Provides-Extra: local-embeddings
+Requires-Dist: sentence-transformers>=3.0.0; extra == 'local-embeddings'
+Description-Content-Type: text/markdown
+
+# NexusMemory
+
+Local-first AI memory layer that gives LLMs persistent, structured memory.
+
+> "We are building the memory operating system that turns AI from a temporary assistant into a long-term collaborator."
+
+## Problem
+
+LLMs are stateless. They forget previous sessions, lose architectural context, repeat mistakes, and require repeated explanations. NexusMemory fixes this by building a persistent knowledge graph from your conversations.
+
+## How It Works
+
+```
+conversation → entity extraction → relationship graph → retrieval → prompt injection
+```
+
+When you tell NexusMemory something, it:
+1. **Extracts** entities, relationships, and decisions using LLM
+2. **Embeds** the text for semantic search
+3. **Builds** a knowledge graph with NetworkX
+4. **Stores** everything in a local SQLite database
+
+When you query, it:
+1. **Searches** semantically similar memories
+2. **Expands** through the knowledge graph
+3. **Reranks** by importance and relevance
+4. **Compresses** into context ready for LLM injection
+
+## Quick Start
+
+### Install
+
+```bash
+pip install -e .
+```
+
+### Configure
+
+```bash
+cp .env.example .env
+# Edit .env and add your OpenAI API key
+```
+
+### Use via CLI
+
+```bash
+# Add a memory
+nexusmemory add "We replaced Airflow with Dagster because DAG maintenance became difficult"
+
+# Search memories
+nexusmemory search "What orchestration tool do we use?"
+
+# Check status
+nexusmemory status
+
+# Get entity info
+nexusmemory entity "Dagster"
+```
+
+### Use via API
+
+```bash
+# Start the server
+nexusmemory serve
+
+# Add memory
+curl -X POST http://localhost:8765/memory/add \
+  -H "Content-Type: application/json" \
+  -d '{"text": "We migrated from MongoDB to PostgreSQL for better ACID compliance"}'
+
+# Query
+curl -X POST http://localhost:8765/memory/query \
+  -H "Content-Type: application/json" \
+  -d '{"query": "What database do we use?"}'
+```
+
+### Use with Claude Code (MCP)
+
+```bash
+# Add as MCP server
+claude mcp add nexusmemory -- nexusmemory mcp
+
+# Or if installed via pip in a specific path:
+claude mcp add nexusmemory -- /path/to/venv/bin/nexusmemory mcp
+```
+
+Available MCP tools:
+- `add_memory` — Store project context
+- `search_memory` — Query past memories
+- `get_project_context` — Get rich context about a topic
+- `find_related` — Explore knowledge graph relationships
+- `get_decisions` — Review past decisions
+- `memory_status` — Check system stats
+
+## Architecture
+
+```
+┌──────────────┐
+│   Interfaces │  CLI / FastAPI / MCP Server
+├──────────────┤
+│     Core     │  NexusMemory orchestration class
+├──────────────┤
+│   Services   │  Extraction, Embedding, Graph, Importance
+├──────────────┤
+│   Storage    │  SQLite + NetworkX (in-memory)
+└──────────────┘
+```
+
+## Tech Stack
+
+- **Python 3.11+** with FastAPI
+- **SQLite** for persistent storage
+- **NetworkX** for in-memory knowledge graph
+- **OpenAI API** for extraction and embeddings
+- **MCP SDK** for Claude Code integration
+
+## Database
+
+Four tables:
+- `memories` — Raw text with embeddings
+- `nodes` — Knowledge graph entities
+- `edges` — Relationships between entities
+- `decisions` — Project decisions with reasoning
+
+## Development
+
+```bash
+# Install with dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Run API server in dev mode
+nexusmemory serve
+```
+
+## License
+
+MIT

nexusmemo-0.1.0/README.md

@@ -0,0 +1,140 @@
+# NexusMemory
+
+Local-first AI memory layer that gives LLMs persistent, structured memory.
+
+> "We are building the memory operating system that turns AI from a temporary assistant into a long-term collaborator."
+
+## Problem
+
+LLMs are stateless. They forget previous sessions, lose architectural context, repeat mistakes, and require repeated explanations. NexusMemory fixes this by building a persistent knowledge graph from your conversations.
+
+## How It Works
+
+```
+conversation → entity extraction → relationship graph → retrieval → prompt injection
+```
+
+When you tell NexusMemory something, it:
+1. **Extracts** entities, relationships, and decisions using LLM
+2. **Embeds** the text for semantic search
+3. **Builds** a knowledge graph with NetworkX
+4. **Stores** everything in a local SQLite database
+
+When you query, it:
+1. **Searches** semantically similar memories
+2. **Expands** through the knowledge graph
+3. **Reranks** by importance and relevance
+4. **Compresses** into context ready for LLM injection
+
+## Quick Start
+
+### Install
+
+```bash
+pip install -e .
+```
+
+### Configure
+
+```bash
+cp .env.example .env
+# Edit .env and add your OpenAI API key
+```
+
+### Use via CLI
+
+```bash
+# Add a memory
+nexusmemory add "We replaced Airflow with Dagster because DAG maintenance became difficult"
+
+# Search memories
+nexusmemory search "What orchestration tool do we use?"
+
+# Check status
+nexusmemory status
+
+# Get entity info
+nexusmemory entity "Dagster"
+```
+
+### Use via API
+
+```bash
+# Start the server
+nexusmemory serve
+
+# Add memory
+curl -X POST http://localhost:8765/memory/add \
+  -H "Content-Type: application/json" \
+  -d '{"text": "We migrated from MongoDB to PostgreSQL for better ACID compliance"}'
+
+# Query
+curl -X POST http://localhost:8765/memory/query \
+  -H "Content-Type: application/json" \
+  -d '{"query": "What database do we use?"}'
+```
+
+### Use with Claude Code (MCP)
+
+```bash
+# Add as MCP server
+claude mcp add nexusmemory -- nexusmemory mcp
+
+# Or if installed via pip in a specific path:
+claude mcp add nexusmemory -- /path/to/venv/bin/nexusmemory mcp
+```
+
+Available MCP tools:
+- `add_memory` — Store project context
+- `search_memory` — Query past memories
+- `get_project_context` — Get rich context about a topic
+- `find_related` — Explore knowledge graph relationships
+- `get_decisions` — Review past decisions
+- `memory_status` — Check system stats
+
+## Architecture
+
+```
+┌──────────────┐
+│   Interfaces │  CLI / FastAPI / MCP Server
+├──────────────┤
+│     Core     │  NexusMemory orchestration class
+├──────────────┤
+│   Services   │  Extraction, Embedding, Graph, Importance
+├──────────────┤
+│   Storage    │  SQLite + NetworkX (in-memory)
+└──────────────┘
+```
+
+## Tech Stack
+
+- **Python 3.11+** with FastAPI
+- **SQLite** for persistent storage
+- **NetworkX** for in-memory knowledge graph
+- **OpenAI API** for extraction and embeddings
+- **MCP SDK** for Claude Code integration
+
+## Database
+
+Four tables:
+- `memories` — Raw text with embeddings
+- `nodes` — Knowledge graph entities
+- `edges` — Relationships between entities
+- `decisions` — Project decisions with reasoning
+
+## Development
+
+```bash
+# Install with dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Run API server in dev mode
+nexusmemory serve
+```
+
+## License
+
+MIT