Metadata-Version: 2.4
Name: brain-neuromem
Version: 0.1.0
Summary: Neuron-connected, local-first associative memory framework for AI agents
Home-page: https://github.com/Elangovan2006M/Artificial-Brain
Author: Elangovan Manickam
Author-email: elangovan.ai.m@gmail.com
License: MIT
Keywords: ai,agent,memory,brain,neuromem,llm,rag
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Provides-Extra: async
Requires-Dist: aiohttp>=3.8; extra == "async"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: provides-extra
Dynamic: requires-python
Dynamic: summary

# Brain (`brain-neuromem`) 🧠⚡

> **Neuron-connected, local-first associative memory framework for AI agent developers.**

Brain is a vendor-agnostic developer framework that gives AI agents a brain-inspired memory architecture. Unlike traditional vector databases or flat memory stores, Brain automatically builds **weighted synaptic connections** between memories based on semantic meaning, entity overlap, and temporal context, enabling multi-hop associative recall.

## Features
- **Vendor-Agnostic & LLM-Independent**: Works with ANY LLM provider (OpenAI, Groq, Ollama, Claude, Gemini, etc.).
- **Label-Free Emergent Synapses**: Synaptic connections form dynamically based on vector space proximity and extracted entity overlap.
- **Associative Multi-Hop Recall**: Recalls direct matches and traverses graph synapses across sessions.
- **Dual-Track Real-Time Pipeline**: Built-in `RealtimeBrainPipeline` combining short-term dialogue buffering, pronoun resolution, and background 3rd-person atomic fact extraction.
- **Hebbian Learning & Decay**: Connections strengthen when co-recalled and naturally decay over time.
- **HNSW Acceleration**: Sub-10ms recall at scale.

## Installation
```bash
pip install brain-neuromem
```

## Quick Example
```python
from neuromem import Brain

brain = Brain("http://localhost:7700/b/my-agent")
brain.remember("User prefers dark mode UI")

memories = brain.recall("what are user preferences?", depth=2)
for m in memories:
    print(m["content"])
```
