https://github.com/kobie3717/ai-iq
AI-IQ: Persistent context system for AI coding assistants. AI doesn't need knowledge — it needs relevant context. Hybrid search (FTS+semantic), graph intelligence, zero config.
https://github.com/kobie3717/ai-iq
ai ai-agents ai-tools claude-code cursor developer-tools fts5 knowledge-graph llm memory sqlite
Last synced: 3 months ago
JSON representation
AI-IQ: Persistent context system for AI coding assistants. AI doesn't need knowledge — it needs relevant context. Hybrid search (FTS+semantic), graph intelligence, zero config.
- Host: GitHub
- URL: https://github.com/kobie3717/ai-iq
- Owner: kobie3717
- License: mit
- Created: 2026-03-10T06:16:53.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-03-26T21:45:58.000Z (3 months ago)
- Last Synced: 2026-03-27T04:27:02.495Z (3 months ago)
- Topics: ai, ai-agents, ai-tools, claude-code, cursor, developer-tools, fts5, knowledge-graph, llm, memory, sqlite
- Language: Python
- Size: 206 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# AI-IQ
Give your AI long-term memory in 1 command.
LLMs forget everything. AI-IQ makes them remember.
## Install
```bash
pip install ai-iq
```
## Quick Start
```python
from ai_iq import Memory
memory = Memory()
# Add memories
memory.add("User prefers dark mode", tags=["preference", "ui"])
memory.add("Redis bug fixed with network_mode: host", category="learning")
# Search (hybrid keyword + semantic)
results = memory.search("redis networking")
for r in results:
print(f"#{r['id']}: {r['content']}")
# Update and delete
memory.update(1, "User STRONGLY prefers dark mode")
memory.delete(1)
```
## CLI
```bash
memory-tool add learning "Docker needs network_mode: host" --project MyApp
memory-tool search "docker networking"
memory-tool dream # Consolidate duplicates, detect conflicts
```
## Claude Code Plugin
Use AI-IQ directly in Claude Code with auto-capture:
```bash
/plugin marketplace add kobie3717/ai-iq
/plugin install ai-iq
```
See [CLAUDE_CODE_PLUGIN.md](CLAUDE_CODE_PLUGIN.md) for details.
## Why AI-IQ?
- **Single SQLite file = your AI's brain** — No servers, no vector DB, no setup
- **No cloud dependencies** — Works offline, owns your data, zero API keys
- **Works with any Python agent** — Not locked to Claude, OpenAI, or any vendor
- **Hybrid search** — Keyword (FTS5) + semantic (vector) + graph traversal
- **Memories decay naturally** — FSRS-6 algorithm like human memory
## Advanced Features
See [docs/REFERENCE.md](docs/REFERENCE.md) for complete documentation:
- **Beliefs & Predictions** — Confidence tracking with Bayesian updates
- **Knowledge Graph** — Entities, relationships, spreading activation
- **Dream Mode** — REM-like consolidation (dedup, conflict detection)
- **Identity Layer** — Auto-discovers behavioral traits
- **Narrative Memory** — Builds cause-effect stories from causal graph
- **Meta-Learning** — Search improves from feedback loops
## Example
See [examples/chatbot_with_memory.py](examples/chatbot_with_memory.py)
## Documentation
[Complete Reference](docs/REFERENCE.md) • [Examples](examples/) • [Architecture](ARCHITECTURE.md)
## Requirements
Python 3.8+ and SQLite 3.37+. Optional: `pip install ai-iq[full]` for semantic search.
## License
MIT
## Links
- **GitHub**: [github.com/kobie3717/ai-iq](https://github.com/kobie3717/ai-iq)
- **PyPI**: [pypi.org/project/ai-iq](https://pypi.org/project/ai-iq/)
- **Discord**: [discord.gg/Y2jCXNGgE](https://discord.gg/Y2jCXNGgE)