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
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file animica-9.5.4-py3-none-any.whl.
File metadata
- Download URL: animica-9.5.4-py3-none-any.whl
- Upload date:
- Size: 8.9 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a19528b64789de94f8f929946b77855deb98a9ca614ce7a9fffd65e265625b1f
|
|
| MD5 |
82f2a33816d76ea6d89ae9b5913b8197
|
|
| BLAKE2b-256 |
895f28765a185dd4513a262ffdb2f2bbcb4b2f675f53fed05d503d64932435c7
|
