Metadata-Version: 2.4
Name: brainos-cli
Version: 1.0.0
Summary: Brain-inspired memory architecture plugins for AI agents.
Author: Nirav Vaghasiya
License: MIT
Project-URL: Homepage, https://github.com/niravvaghasiya/BrainOS
Project-URL: Repository, https://github.com/niravvaghasiya/BrainOS
Keywords: ai,memory,agents,rag,llm,cognitive-architecture
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: click>=8.0
Requires-Dist: rich>=13.0
Provides-Extra: all
Requires-Dist: numpy>=1.24; extra == "all"
Requires-Dist: sentence-transformers>=2.2; extra == "all"
Requires-Dist: chromadb>=0.4; extra == "all"
Requires-Dist: networkx>=3.0; extra == "all"

# brainos CLI

Install brain-inspired memory plugins into your AI agent project.

## Install

```bash
pip install brainos

```

Or install from source:

```bash
cd cli/
pip install -e .

```

## Usage

```bash
# List all plugins
brainos list

# Initialize project structure
brainos init

# Add a plugin
brainos add sensory-gate
brainos add hippocampal-index --with-config --with-tests

# Add all plugins
brainos add all

# Plugin details
brainos info attention-filter

```

## What gets generated

```
your-project/
  brainos_plugins/
    __init__.py
    sensory_gate.py        <- Working Python class
    attention_filter.py
  config/
    sensory_gate.yaml      <- Config template
  tests/
    test_sensory_gate.py   <- Test skeleton

```

## Plugins

| Name | Brain Analog | Saves |
| --- | --- | --- |
| sensory-gate | Thalamic Filter | 50-80% tokens |
| attention-filter | Selective Attention | 40-70% tokens |
| working-memory | Prefrontal WM | 25-45% tokens |
| hippocampal-index | Hippocampus | 20-40% tokens |
| consolidator | Sleep Consolidation | 60-80% storage |
| episodic-store | Episodic Memory | - |
| semantic-store | Knowledge Graph | - |
| procedural-cache | Basal Ganglia | 30-50% tokens |
| salience-tagger | Amygdala | 20-40% tokens |
| forgetting-engine | Active Forgetting | Prevents bloat |
| dmn-incubator | Default Mode Network | - |
| metacognition | Prefrontal Monitor | Compounds |

