---
id: anima-python
version: "0.20.245"
license: unclear
license_treatment: unclear
maintenance: active
---

# anima-python — anima substrate-native consciousness engine — py CLI (measurement/eval · serialize · corpus · sweep), hexa-toolchain-free numpy distribution

License: unclear · Maintenance: active · Downloads: 173.4K/mo

## What it is and what it does

anima-python is a command-line interface to the anima consciousness engine, designed to run on systems without the hexa toolchain. It wraps a single dispatcher (cli/anima.py:main) and is distributed via pip as an alternative to the hexa channel installation. The package provides measurement, evaluation, serialization, and corpus generation capabilities.

The base installation requires only numpy and supports evaluation, corpus generation, and a chat stub. Optional [train] extras add torch and datasets for serialization, hyperparameter sweeps, and training workflows. Commands like evaluate produce measurements compatible with hexa's deterministic evaluation path and are considered terminal-eligible. Larger checkpoints (303M+) are restricted from mini environments.

Use it for:

- Run model evaluation and measurement on systems without hexa installed, using only numpy
- Generate procedural learning corpora in different formats (derivtrace or flat) for training pipelines
- Serialize and deserialize model checkpoints when torch is available via the [train] extra
- Execute hyperparameter sweeps across multiple arms and objectives in a training pool
- Access the anima consciousness engine's chat interface as an entry point to hexa workflows

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

anima-python provides a command-line interface to the anima consciousness engine for measurement, evaluation, serialization, and corpus generation, runnable with only numpy on systems without the hexa toolchain.

Yes, if you need a lightweight, numpy-only CLI for anima engine evaluation and corpus generation on hexa-free systems. The low install friction and active maintenance are favorable. However, verify the license status before production use, and confirm the package is available on PyPI (documentation indicates it may still be awaiting publication). The [train] extras add significant dependencies; install only if you need those capabilities.

## Install

pip install anima-python
uv add anima-python
poetry add anima-python

## Installing anima-python

Before you install: Active maintenance with a recent release (19 days old). Low install friction—pure Python wheel with only numpy as a runtime dependency. Requires Python 3.9 or later.

License in practice: License status is unclear; no SPDX identifier or raw license text is declared in the package metadata. Verify licensing terms before use in proprietary or restricted contexts.

Quickstart:

pip install anima-python
# or with training support:
pip install "anima-python[train]"

from anima_python import cli
cli.main()

Requires Python 3.9+. Some commands (serialize, sweep, train) require the [train] extra, which adds torch and datasets dependencies.

Verify before relying:

- Whether the package is actually published on PyPI or still requires installation from git source
- What the 'anima substrate-native consciousness engine' actually computes and whether it is suitable for your use case
- Whether the [train] extra's torch and datasets dependencies are compatible with your environment

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 173.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

anima cli measurement evaluation, consciousness engine python, numpy-only ml evaluation, model corpus generation, hexa-free training tools, cli-tool, model-evaluation, numpy-native

[View on SkillFed](https://skillfed.io/packages/anima-python) · [View on PyPI](https://pypi.org/project/anima-python/)