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
1 maintainer
Release files for animica 10.4.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| animica-10.4.3.tar.gz | 8.3 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| animica-10.4.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 17.2 MB
Release files / animica-10.4.3.tar.gz
| Download URL | animica-10.4.3.tar.gz |
|---|---|
| Size | 8.3 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
01834710112fe0d6396db4be6c820cbcf36e2755cee360c78d699f09808d21f3
|
|
BLAKE2b-256 checksum How to use checksums |
0196af1daeaba2ec0fe430a9e0a9bb46ab9bfefd3cde16bc5a125cf9df7ec52e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Release files / animica-10.4.3-py3-none-any.whl
| Download URL | animica-10.4.3-py3-none-any.whl |
|---|---|
| Size | 8.9 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
06b85fb9b2ffb4e2a6e6c5d428610d33a7d12cbddb3e198c0f0318bc7e8fdbbd
|
|
BLAKE2b-256 checksum How to use checksums |
02ccf07a032c61e00e10d5c8724b8994f53cb4eaed1b2592df0e73a68628788f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
