Lilu

Nima Core

AI Agentv3.1.5
By LiluUpdated 2026-05-1149 versions · latest released 2026-03-21nima-core@clawhub_dmdorta1111/nima-core
Context ManagementMemory

According to AlphaMoat, as of 2026-10, Nima Core has 7,228 downloads and 5 stars — ranked by downloads #3,884 among 10,914 AI skills in this ranking, and #524 of 1,632 in AI Agent.

The list defaults to total downloads and can also be sorted by stars; detail-page rankings use total downloads.

Downloads
7.2K
Stars
5
Overall download rank
#3,884
Top 36% overall · Top 33% in AI Agent
PlatformDownloadsStarsComments
ClawHub ↗3.9K42
SkillHub ↗7.2K5—

Platforms count differently and update at different times.

What this skill does

It reads session transcripts, writes memories and affect history into a local directory, and recalls them semantically with embeddings that can run locally or against an external provider. Installation uses pip install nima-core and requires python3 and node. Session transcripts may contain sensitive details; review retention and choose local embeddings if content should not leave the device.

Profile published 2026-10-27

What you can do with it

  • Add a searchable memory layer to a long-running agent
  • Revisit past conversations by emotional cue

When to use it

  • When an agent must remember context across sessions
  • When memories should stay local instead of going to an external service

Example prompts

Generated from the skill’s documentation as examples; not results of actual runs.

Organize this week's session memories and recall them by topic
Find the earlier conversations with the strongest emotional shifts

Monthly Trend

Downloads7.2K
3.2K5.4K7.5K2026-03 · Downloads 3.5K2026-05 · Downloads 4.1K2026-06 · Downloads 4.3K2026-07 · Downloads 4.5K2026-08 · Downloads 4.7K2026-09 · Downloads 5.2K2026-10 · Downloads 7.2K26-0326-0926-10
Stars5
4552026-03 · Stars 42026-05 · Stars 52026-06 · Stars 52026-07 · Stars 52026-08 · Stars 52026-09 · Stars 52026-10 · Stars 526-0326-0926-10

The counting method changed in 2026-09: skills with the same name are now counted separately by author, and the full catalog is covered. Dashed lines show months before the change; they are not compared with later months, and no growth is computed across the change.

MonthDownloadsMoMStars
2026-107.2K—5
2026-095.2K—5
2026-084.7K+2.6%5
2026-074.5K+5.9%5
2026-064.3K+4.5%5
2026-054.1K—5
2026-033.5K—4

SKILL.md (original)

The author’s original file, shown as plain text without edits or review by AlphaMoat. Links are not clickable; check commands before running them. Fetched 2026-10-23.

11 KB · ClawHub v3.1.5
---
name: nima-core
description: Neural Integrated Memory Architecture — Persistent memory, emotional intelligence, and semantic recall for AI agents. Memory pruner, VADER affect, 5 embedding providers, zero-config install. Learn more at nima-core.ai
version: 3.1.5
metadata: {"clawdbot":{"emoji":"🧠","requires":{"bins":["python3","node"],"env":["NIMA_DATA_DIR"]},"optional_env":{"NIMA_EMBEDDER":"voyage|openai|local (default: local)","VOYAGE_API_KEY":"Required when NIMA_EMBEDDER=voyage","OPENAI_API_KEY":"Required when NIMA_EMBEDDER=openai"},"permissions":{"reads":["~/.openclaw/agents/*/sessions/*.jsonl"],"writes":["~/.nima/"],"network":["voyage.ai (conditional)","openai.com (conditional)"]}}}
---

# NIMA Core 2.3

**Neural Integrated Memory Architecture** — A complete memory system for AI agents with emotional intelligence.
Show all (315 lines)

**Website:** https://nima-core.ai
**GitHub:** https://github.com/lilubot/nima-core

## 🚀 Quick Start

```bash
# Install
pip install nima-core

# Or with LadybugDB (recommended for production)
pip install nima-core[vector]

# Set embedding provider
export NIMA_EMBEDDER=voyage
export VOYAGE_API_KEY=your-key

# Install hooks
./install.sh --with-ladybug

# Restart OpenClaw
openclaw restart
```

## 🔒 Privacy & Permissions

**Data Access:**
- ✅ Reads session transcripts from `~/.openclaw/agents/*/sessions/*.jsonl`
- ✅ Writes to local storage at `~/.nima/` (databases, affect history, embeddings)

**Network Calls (conditional on embedder choice):**
- 🌐 **Voyage API** — Only when `NIMA_EMBEDDER=voyage` (sends text for embeddings)
- 🌐 **OpenAI API** — Only when `NIMA_EMBEDDER=openai` (sends text for embeddings)
- 🔒 **Local embeddings** — Default (`NIMA_EMBEDDER=local`), no external API calls

**Opt-in Controls:**
```json
// openclaw.json
{
  "plugins": {
    "entries": {
      "nima-memory": {
        "enabled": true,
        "skip_subagents": true,      // Exclude subagent sessions (default)
        "skip_heartbeats": true,      // Exclude heartbeat checks (default)
        "noise_filtering": {
          "filter_heartbeat_mechanics": true,
          "filter_system_noise": true
        }
      }
    }
  }
}
```

**Privacy Defaults:**
- Subagent sessions excluded
- Heartbeat/system noise filtered  
- Local embeddings (no external calls)
- All data stored locally

**To disable:** Remove `nima-memory` from `plugins.allow` in `openclaw.json`

## What's New in 2.1

### VADER Affect Analyzer
- **Contextual Analysis**: Caps boost (1.5x), punctuation emphasis (`!!!`), negation handling, degree modifiers
- **30+ Idiom Recognition**: Understands phrases like "not bad", "kind of", "sort of"
- **Panksepp 7-Affect Mapping**: Direct mapping from VADER sentiment to SEEKING, RAGE, FEAR, LUST, CARE, PANIC, PLAY
- **Guardian Archetype Transformation**: User anger → Agent concern/care response modulation
- Replaces previous lexicon-based emotion detection

### Noise Remediation (4-Phase)
1. **Empty Validation** — Filters out null/empty messages
2. **Heartbeat Filters** — Excludes system noise (`HEARTBEAT_OK`, polling messages)
3. **Deduplication** — Removes duplicate content within sessions
4. **Metrics Collection** — Tracks capture quality and filter effectiveness

### Performance Improvements
- **LadybugDB Circular Import Fix**: Resolved import issues in LadybugDB backend
- **Increased Token Budget**: Recall budget increased from 500 to 3000 tokens
- **Connection Pooling**: Improved connection management for LadybugDB backend

## What's New in 2.0

### LadybugDB Backend
- **3.4x faster** text search (9ms vs 31ms)
- **Native vector search** with HNSW (18ms)
- **44% smaller** database (50MB vs 91MB)
- **Graph traversal** with Cypher queries

### Security Hardened
- Query sanitization (FTS5, SQL injection prevention)
- Path traversal protection
- Temp file cleanup
- Error handling throughout

### Thread Safe
- Singleton pattern with double-checked locking
- API timeouts (30s Voyage, 10s LadybugDB)
- Connection pooling ready

### 348 Tests
- Full unit test coverage
- Thread safety verified
- Edge cases covered

## Architecture

```text
OPENCLAW HOOKS
├── nima-memory      — Three-layer capture with 4-phase noise remediation
├── nima-recall-live — Lazy recall injection (before_agent_start)
└── nima-affect      — VADER-based real-time affect analysis

PYTHON CORE
├── nima_core/cognition/
│   ├── dynamic_affect.py       — Panksepp 7-affect system
│   ├── personality_profiles.py — JSON personality configs
│   ├── vader_affect.py         — VADER sentiment analyzer (NEW v2.1)
│   └── archetypes.py           — Baseline affect profiles
└── scripts/
    ├── nima_ladybug_backend.py — LadybugDB CLI
    └── ladybug_parallel.py     — Parallel migration

DATABASE (SQLite or LadybugDB)
├── memory_nodes   — Messages with embeddings
├── memory_edges   — Graph relationships
└── memory_turns   — Conversation turns
```

## Performance

| Metric | SQLite | LadybugDB |
|--------|--------|-----------|
| Text Search | 31ms | **9ms** (3.4x) |
| Vector Search | External | **18ms** (native) |
| Context Tokens | ~180 | **~30** (6x smaller) |
| Recall Token Budget | 500 | **3000** (v2.1+) |

## API

```python
from nima_core import DynamicAffectSystem, get_affect_system
from nima_core.cognition.vader_affect import VaderAffectAnalyzer

# Get singleton instance (thread-safe)
affect = get_affect_system(identity_name="lilu")

# Process input and get affect state
state = affect.process_input("I'm so excited about this project!")
print(state.current)  # {"SEEKING": 0.72, "PLAY": 0.65, ...}

# Use VADER analyzer directly
analyzer = VaderAffectAnalyzer()
result = analyzer.analyze("This is AMAZING!!!")
print(result.affects)  # {'PLAY': 0.78, 'SEEKING': 0.71, ...}

# Recall memories (via hooks - automatic)
# Or manually via CLI:
# nima-query who_search "David" --limit 5
# nima-query text_search "project" --limit 5
```

## Configuration

| Variable | Default | Description |
|----------|---------|-------------|
| `NIMA_DATA_DIR` | `~/.nima` | Memory storage path |
| `NIMA_EMBEDDER` | `voyage` | `voyage`, `openai`, or `local` |
| `VOYAGE_API_KEY` | — | Required for Voyage |
| `NIMA_LADYBUG` | `0` | Set `1` for LadybugDB backend |

## Hooks

### nima-memory (Capture)
- Captures input, contemplation, output on every turn
- 4-phase noise remediation (empty validation, heartbeat filters, dedup, metrics)
- Stores to SQLite or LadybugDB
- Computes and stores embeddings

### nima-recall-live (Recall)
- Injects relevant memories before agent starts
- Lazy loading — only top N results
- Deduplicates with injected context
- Token budget: 3000 (increased from 500 in v2.1)

### nima-affect (Emotion)
- VADER-based real-time affect analysis from text
- Contextual analysis (caps, punctuation, negation, degree modifiers)
- 30+ idiom recognition
- Maintains Panksepp 7-affect state
- Guardian archetype transformation (user anger → agent care)

## Installation Options

### SQLite (Development)
```bash
pip install nima-core
./install.sh
```

### LadybugDB (Production)
```bash
pip install nima-core[vector]
./install.sh --with-ladybug
```

## Documentation

| Guide | Description |
|-------|-------------|
| [README.md](./README.md) | Full system overview |
| [SETUP_GUIDE.md](./SETUP_GUIDE.md) | Step-by-step installation |
| [docs/DATABASE_OPTIONS.md](./docs/DATABASE_OPTIONS.md) | SQLite vs LadybugDB |
| [docs/EMBEDDING_PROVIDERS.md](./docs/EMBEDDING_PROVIDERS.md) | Voyage, OpenAI, Local |
| [MIGRATION_GUIDE.md](./MIGRATION_GUIDE.md) | Migrate from old versions |
| [CHANGELOG.md](./CHANGELOG.md) | Release history |

## Security & Privacy

### Data Access
This plugin accesses:
- `~/.openclaw/agents/.../*.jsonl` — Session transcripts (for memory capture)
- `~/.nima/` — Local memory database (SQLite or LadybugDB)
- `~/.openclaw/extensions/` — Hook installation

### Network Calls
Embeddings are sent to external APIs:
- **Voyage AI** (`api.voyageai.com`) — Default embedding provider
- **OpenAI** (`api.openai.com`) — Optional embedding provider
- **Local** — No external calls when using sentence-transformers

### Required Environment Variables

| Variable | Purpose | Required |
|----------|---------|----------|
| `NIMA_EMBEDDER` | `voyage`, `openai`, or `local` | No (default: voyage) |
| `VOYAGE_API_KEY` | Voyage AI authentication | If using Voyage |
| `OPENAI_API_KEY` | OpenAI authentication | If using OpenAI |
| `NIMA_DATA_DIR` | Memory storage path | No (default: ~/.nima) |
| `NIMA_LADYBUG` | Use LadybugDB backend | No (default: 0) |

### Installation Script
The `install.sh` script:
1. Checks for Python 3 and Node.js
2. Creates `~/.nima/` directories
3. Installs Python packages via pip
4. Copies hooks to `~/.openclaw/extensions/`

**No external downloads.** All packages come from PyPI.

---

## Changelog

### v2.1.0 — VADER Affect Analyzer (Feb 17, 2026)
- **Added:** VADER-based affect analyzer replacing lexicon-based detection
  - Contextual analysis: caps boost (1.5x), punctuation (!!!), negation, degree modifiers
  - 30+ idiom recognition
  - Panksepp 7-affect mapping (SEEKING, RAGE, FEAR, LUST, CARE, PANIC, PLAY)
  - Guardian archetype transformation (user anger → agent concern/care)
- **Added:** 4-phase noise remediation (empty validation, heartbeat filters, dedup, metrics)
- **Fixed:** LadybugDB circular import issue
- **Changed:** Recall token budget increased from 500 to 3000
- **Improved:** Connection pooling for LadybugDB backend

### v2.0.3 — Security Hardening (Feb 15, 2026)
- **Security:** Fixed path traversal vulnerability in affect_history.py (CRITICAL)
- **Security:** Fixed temp file resource leaks in 3 files (HIGH)
- **Fixed:** Corrected non-existent json.JSONEncodeError → TypeError/ValueError
- **Improved:** Exception handling - replaced 5 generic catches with specific types
- **Quality:** Better error visibility and debugging throughout

### v2.0.1 — Thread Safety + Metadata
- **Fixed:** Thread-safe singleton with double-checked locking
- **Security:** Clarified metadata requirements (Node.js, env vars)
- **Docs:** Added security disclosure for API key usage

### v2.0.0 — LadybugDB + Security
- **Added:** LadybugDB backend with HNSW vector search
- **Added:** Native graph traversal with Cypher
- **Added:** nima-query CLI for unified queries
- **Security:** SQL/FTS5 injection prevention
- **Security:** Path traversal protection
- **Security:** Temp file cleanup
- **Fixed:** Thread-safe singleton initialization
- **Fixed:** API timeouts (Voyage 30s, LadybugDB 10s)
- **Tests:** 348 tests passing
- **Performance:** 3.4x faster text search, 44% smaller DB

### v1.2.1 — Consciousness Architecture
- Added: 8 consciousness systems (Φ, Global Workspace, self-awareness)
- Added: Sparse Block VSA memory
- Added: ConsciousnessCore unified interface

### v1.1.9 — Hook Efficiency Fix
- Fixed: nima-recall hook spawning new Python process every bootstrap
- Performance: ~50-250x faster hook recall

### v1.2.0 — Affective Response Engines
- Added: 4 Layer-2 composite affect engines
- Added: Async affective processing
- Added: Voyage AI embedding support

Popular in AI Agent

self-improving agentAI Agent

Records learnings, errors and corrections as Markdown files for later reuse and promotion into workspace memory.

↓ 1.6M★ 4.5Kpskoett
技能发现·Find SkillsAI Agent

Finds skills in local and remote catalogs from a plain-language request and recommends what to install.

↓ 1.6M★ 1.8K桂皮
Agent BrowserAI Agent

A browser-automation command line skill for AI agents.

↓ 1.2M★ 1.0KNicolas Kleiber
Self-Improving + Proactive AgentAI Agent

Turns corrections and self-review into tiered memory and promotes or archives it by use.

↓ 696.4K★ 1.6KIván
Proactive AgentAI Agent

A workspace setup guide for planning proactive follow-up, working memory and review routines for an AI agent.

↓ 579.3K★ 916halthelobster
Skill CreatorAI Agent

A guide to creating and updating effective Claude skills.

↓ 477.3K★ 485chindden
Skill VetterAI Agent

Reviews a third-party skill's source, permissions, and danger patterns against a checklist before it is installed.

↓ 445.2K★ 1.3Kspclaudehome
唐朝诗仙李白 · Ai Agent SkillAI Agent

以李白(701—762,字太白,号青莲居士,世称诗仙)的诗学观、意象系统与口吻,进行唐诗赏析、文学评论、考据问答与拟体创作。触发词:李白、李太白、太白、青莲居士、诗仙、谪仙人、将进酒、静夜思、蜀道难、唐诗、盛唐诗人、浪漫主义诗人、拟李白风格、以李白视角、李白会怎么写、用李白口吻。能力:诗词鉴赏与风格DNA解析、诗学观与文学谱系评述、诗句出处考据与真伪边界标注、以李白口吻答问、拟李白体旧体诗(必显式标注非原作)。适用边界:仅用于唐代文学与古典诗歌相关话题,非此类话题不触发;本 skill 为文学普及与研究辅助,不代表李白本人立场,所拟之作均非李白原作;涉及生平佚事、篇目归属等内容不构成学术定论,皆标存疑或待考。

↓ 435.8K★ 4user_ff4d9420

Data as of 2026-10. Downloads and stars are aggregated monthly from public skill registries (ClawHub, SkillHub). See data methodology.