ai-iq
agent
Fail
Health Warn
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 8 GitHub stars
Code Fail
- execSync — Synchronous shell command execution in hooks/search-feedback.mjs
Permissions Pass
- Permissions — No dangerous permissions requested
Purpose
This tool provides a persistent memory and context system for AI coding assistants. It uses a local SQLite database to store, search, and consolidate information, allowing AI agents to remember past interactions and user preferences.
Security Assessment
Overall risk: Medium. The tool uses a local SQLite file and does not require cloud dependencies or API keys, which is good for data privacy. There are no hardcoded secrets or dangerous permissions requested. However, the audit flagged synchronous shell command execution in `hooks/search-feedback.mjs`. Executing shell commands, especially synchronously, can be a security risk if the tool processes untrusted external inputs that could trigger a command injection. Developers should inspect this file carefully to understand the context of the execution.
Quality Assessment
The project is very new and has low community visibility, currently sitting at only 8 GitHub stars. It is actively maintained, with the most recent code push occurring today. The repository is properly licensed under the standard MIT license. Because of the extremely low star count and lack of widespread community adoption, it is difficult to assess its reliability or real-world stability based on public trust metrics alone.
Verdict
Use with caution. The project is active and MIT-licensed, but developers should manually review the synchronous shell execution in the hooks before integrating it into sensitive environments.
This tool provides a persistent memory and context system for AI coding assistants. It uses a local SQLite database to store, search, and consolidate information, allowing AI agents to remember past interactions and user preferences.
Security Assessment
Overall risk: Medium. The tool uses a local SQLite file and does not require cloud dependencies or API keys, which is good for data privacy. There are no hardcoded secrets or dangerous permissions requested. However, the audit flagged synchronous shell command execution in `hooks/search-feedback.mjs`. Executing shell commands, especially synchronously, can be a security risk if the tool processes untrusted external inputs that could trigger a command injection. Developers should inspect this file carefully to understand the context of the execution.
Quality Assessment
The project is very new and has low community visibility, currently sitting at only 8 GitHub stars. It is actively maintained, with the most recent code push occurring today. The repository is properly licensed under the standard MIT license. Because of the extremely low star count and lack of widespread community adoption, it is difficult to assess its reliability or real-world stability based on public trust metrics alone.
Verdict
Use with caution. The project is active and MIT-licensed, but developers should manually review the synchronous shell execution in the hooks before integrating it into sensitive environments.
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.
README.md
AI-IQ
Give your AI long-term memory in 1 command.
LLMs forget everything. AI-IQ makes them remember.
Install
pip install ai-iq
Quick Start
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
memory-tool add learning "Docker needs network_mode: host" --project MyApp
memory-tool search "docker networking"
memory-tool dream # Consolidate duplicates, detect conflicts
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 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
Documentation
Complete Reference • Examples • Architecture
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
- PyPI: pypi.org/project/ai-iq
- Discord: discord.gg/Y2jCXNGgE
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found