Sign inSign up

nubaeon/empirica

By nubaeon

•Updated about 3 hours ago

Cognitive OS -- Git-native epistemic middleware enabling genuine self-awareness.

Image
Machine learning & AI
Developer tools
Operating systems
0

10K+

nubaeon/empirica repository overview

⁠Empirica

Cognitive OS for AI Agents — Epistemic self-awareness framework

Teaching AI to know what it knows—and what it doesn't.


⁠Quick Start

# Security-hardened Alpine (recommended)
docker pull nubaeon/empirica:1.5.9-alpine

# Debian slim (glibc compatibility)
docker pull nubaeon/empirica:1.5.9

# Run with persistent data
docker run -it -v $(pwd)/.empirica:/data/.empirica nubaeon/empirica:1.5.9-alpine /bin/sh

⁠Image Variants

TagBaseSizeUse Case
1.5.9-alpineAlpine 3.23~85MBProduction, security-hardened
1.5.9Debian Bookworm~150MBDevelopment, glibc compatibility
latestDebian Bookworm~150MBTracks latest stable

⁠Usage

# CLI help
docker run --rm nubaeon/empirica:1.5.9-alpine empirica --help

# Create a session
docker run -it -v $(pwd)/.empirica:/data/.empirica \
  nubaeon/empirica:1.5.9-alpine \
  empirica session-create --ai-id docker-agent

# Check version
docker run --rm nubaeon/empirica:1.5.9-alpine empirica --version

⁠Environment Variables

VariableDescriptionDefault
EMPIRICA_HOMEData directory/data/.empirica
EMPIRICA_QDRANT_URLQdrant server for semantic memory(none)

⁠What's New in 1.5.9

  • Dynamic Sentinel control (file-based, no restart needed)
  • Epistemic transaction planning mode
  • Dual-track grounded calibration
  • Multi-platform support (Claude Code, Gemini CLI, Cline, Copilot CLI, Kiro, Cursor)

Tag summary

Content type

Image

Digest

sha256:358140667…

Size

140.9 MB

Last updated

about 3 hours ago

docker pull nubaeon/empirica