whitemagic 23.0.0

Cognitive operating system for AI agents — 490 tools across 28 Gana meta-tools, 5D holographic memory, ethical governance, and 7-language polyglot acceleration

WhiteMagic — Agentic AI Platform (v23.0.0)

A polyglot agentic AI platform with Python core, Rust performance bridges, and multi-language support for AI agents, memory systems, and distributed orchestration.

Installation

Lite (MCP + CLI only)

pip install -e ".[dev,mcp,cli]"

Core (standard installation with database + networking)

pip install -e ".[dev,mcp,cli,core]"

Heavy-tier (full ML stack with embeddings + search)

pip install -e ".[dev,mcp,cli,heavy]"

Quick Start

MCP Server (FastMCP)

python -m whitemagic.run_mcp

MCP Server (Lean — stdlib only)

python -m whitemagic.run_mcp_lean

CLI

wm status
wm doctor

Project Structure

whitemagic/
├── core/           # Core systems (memory, intelligence, governance)
├── tools/          # Tool handlers and dispatch
├── security/       # Security, sanitization, tool gating
├── config/         # Configuration and paths
├── cli/            # Command-line interface
├── rust/           # Rust bridge implementations
└── polyglot/       # Multi-language bridges (Koka, Zig, Mojo, etc.)

Development

Run Tests

make test              # Full test suite
make test-core         # Release-critical contract tests only (fast)
pytest tests/          # Direct pytest invocation

Release Validation

make check-ship        # Validate ship surface hygiene

Lint & Typecheck

make lint
make typecheck

Build Rust Extensions

cd whitemagic-rust
maturin develop

Architecture

• Dispatch Pipeline: 9 composable middlewares (sanitizer, circuit breaker, rate limiter, security monitor, tool permissions, maturity gate, governor, observability)
• Memory System: Unified SQLite backend with holographic spatial index, galactic distance tracking, and consolidation
• PRAT Ganas: 28 meta-tools organized into 4 quadrants (Horn, Dipper, Willow, Room)
• Polyglot Bridges: Rust, Koka, Zig, Mojo, Go, Elixir, Julia, Haskell, Erlang, Nim

Documentation

See the workspace root ../README.md for monorepo structure and project overview. See docs/ for detailed documentation.

License

MIT License — see LICENSE file at repository root.