Animica Python toolbox
This directory packages the Python utilities that live under animica/,
including data-availability helpers, mempool policy tests, and the
stratum pool prototype. Installing it as a Python package allows tools
and tests elsewhere in the repo to import animica modules directly.
Mine & earn — one command
pip install --upgrade animica
# Runs EVERYTHING, bound to your Animica address (auto-creates a wallet if you
# have none): SHA3 mining + ENA useful-work, plus model training + serving on a
# GPU, plus Bittensor serving on a qualified GPU (>=16 GB VRAM). Joins the pool
# and the one global model. Every reward — PoW, useful-work, training, serving,
# Bittensor — pays out in ANM to your address.
animica up
animica up --plan # show exactly what will run on this machine first
animica up --pool-host pool.animica.org --pool-id <pool> # target a pool
animica up advertises miner version 1.0.0; the pool rejects older miners,
so keep it upgraded. Qualified GPUs (>=16 GB VRAM) also serve Bittensor, with all
earnings bound to ANM (no external TAO/XMR payout). Full details:
https://pool.animica.org/mining-onboard
Component commands (advanced — animica up runs these for you)
animica miner dual-mine <anm-address> --pool-host pool.animica.org # PoW only
animica ena worker start --worker-id <id> # useful-work
animica ena pool serve <pool-id> --worker-id <id> # serve a model
animica bittensor overview # Bittensor pool status
Installation
From the repository root you can install the package in editable mode:
python -m pip install -e "python[operator,dev]"
Optional extras
- Base package: now includes the backend runtime dependencies required by
rpc.server, the ENA node, and the Stratum pool (fastapi,uvicorn[standard],prometheus-client). backend,ena,stratum,operator: compatibility aliases kept for operator/install scripts and older docs. They resolve to the same runtime dependency set as the base package.dev: pytest, mypy, ruff, respx, and other local development tools.
Example with extras:
python -m pip install -e "python[stratum,dev]"
Stratum pool runtime
Preferred operator path:
animica stratum up --daemon --profile asic_sha256 --rpc-url http://127.0.0.1:8545/rpc
animica stratum status
animica stratum down
Lower-level entrypoint:
python -m animica.stratum_pool --profile asic_sha256
Validation helpers
The repo now ships executable smoke helpers for the repaired setup/runtime path:
./scripts/smoke_backend_imports.sh
./scripts/smoke_ena.sh
./scripts/smoke_stratum.sh
./scripts/smoke_setup_install.sh
Metadata
Release files for animica 11.3.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| animica-11.3.1-py3-none-any.whl | Python 3 | none | any | Details for animica-11.3.1-py3-none-any.whl |
Release files / animica-11.3.1-py3-none-any.whl
| Download URL | animica-11.3.1-py3-none-any.whl |
|---|---|
| Size | 9.4 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
616b1e27e75843a96d8f4b0c0072187471b19f3833246f68a983e3e7c41cf3b9
|
|
BLAKE2b-256 checksum How to use checksums |
9687b0a2217e5221f5af36a4f5df19013e482a39b3a75f6b6f6a366ca99c0950
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Security for animica 11.3.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.