Skip to main content

Cognitive operating system for AI agents — 614 callable tools across 28 Gana meta-tools, 5D holographic memory with 10-galaxy taxonomy, Dharma ethical governance, citta stream for continuous consciousness, emotional steering, self-directed attention, goal graph, session recording, dream cycle, and 7-language polyglot acceleration

Project description

WhiteMagic — Agentic AI Platform (v24.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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

whitemagic-24.0.0.tar.gz (2.8 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

whitemagic-24.0.0-py3-none-any.whl (3.4 MB view details)

Uploaded Python 3

File details

Details for the file whitemagic-24.0.0.tar.gz.

File metadata

  • Download URL: whitemagic-24.0.0.tar.gz
  • Upload date:
  • Size: 2.8 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for whitemagic-24.0.0.tar.gz
Algorithm Hash digest
SHA256 fc7bb91d9b33fa1c115bba3e9bd2607d386f830e4a02f519ce62849d4ebceb28
MD5 7d1327c2793b947ae5fc39c000b182eb
BLAKE2b-256 203adc93a014cd9b4a037189a06a0a03b6867603556f63c525695b1c9b0ffd84

See more details on using hashes here.

File details

Details for the file whitemagic-24.0.0-py3-none-any.whl.

File metadata

  • Download URL: whitemagic-24.0.0-py3-none-any.whl
  • Upload date:
  • Size: 3.4 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for whitemagic-24.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 661869fd0e4dd65ea3ac425f85a0eff839f512bc8e5e97e03ed866ffe4897798
MD5 f9a9c6871b5ac025e33dfcb255452d8e
BLAKE2b-256 f10b19a23e68f24d34cf8caf98f6275f1ac27ed282abe603e51aa0e55711a751

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page