Algomancy
Algomancy is a lightweight framework for building interactive dashboards that visualize the performance of algorithms and/or simulations across scenarios. It brings together ETL, scenario orchestration, KPI computation, and a Dash-based UI with modular pages.
Highlights
- Python 3.14+
- Dash UI with modular pages and a production-ready server
- Batteries-included packages: content, data, scenario, GUI, API
Installation
- Using uv (recommended):
uv add algomancy - Using pip:
pip install algomancy
Minimal example
The following example launches a small placeholder dashboard using the default building blocks from the Algomancy ecosystem. Copy this into a file called main.py and run it.
Set up folder structure
- Create the following directory structure:
root/
|── assets/ (*)
├── data/ (*)
├── src/
│ ├── data_handling/
│ ├── pages/
│ └── templates/
│ ├── kpi/
│ └── algorithm/
├── main.py (*)
├── README.md
└── pyproject.toml
Only the items marked (*) are required.
- create
main.py
from algomancy_data import DataSource
from algomancy_gui.configuration.appconfig import AppConfig
from algomancy_gui.configuration.serverconfig import ServerConfig
from algomancy_gui.gui_launcher import GuiLauncher
from algomancy_scenario.core_configuration import CoreConfig
from algomancy_content import (
PlaceholderETLFactory,
PlaceholderAlgorithm,
PlaceholderKPI,
PlaceholderSchema,
)
def main() -> None:
app_cfg = AppConfig(
core_config=CoreConfig(
etl_factory=PlaceholderETLFactory,
kpis={"placeholder": PlaceholderKPI},
algorithms={"placeholder": PlaceholderAlgorithm},
schemas=[PlaceholderSchema()],
data_object_type=DataSource,
autocreate=False,
autorun=False,
title="My Algomancy Dashboard",
),
server_config=ServerConfig(host="127.0.0.1", port=8050),
)
app = GuiLauncher.build(app_cfg)
GuiLauncher.run(app=app, host=app_cfg.server.host, port=app_cfg.server.port)
if __name__ == "__main__":
main()
Run
- Save the file as
main.pyand start the app:uv run main.py - Open your browser at http://127.0.0.1:8050
Examples
- A more complete example (including assets and templates) is available in the algomancy repository under
example/. The entry point isexample/main.py.
Requirements
- Python 3.14+
- Windows, macOS, or Linux
License
- See the
LICENSEfile included with this distribution.
Changelog
- See
changelog.mdfor notable changes.
Metadata
Release files for Algomancy 0.10.0
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 |
|---|---|---|---|---|
| algomancy-0.10.0-py3-none-any.whl | Python 3 | none | any | Details for algomancy-0.10.0-py3-none-any.whl |
Release files / algomancy-0.10.0-py3-none-any.whl
| Download URL | algomancy-0.10.0-py3-none-any.whl |
|---|---|
| Size | 4.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6ddfc81aa3856f2e3adf10405ee456d69ae1e136a0cb9f28514fc2e4796b1d53
|
|
BLAKE2b-256 checksum How to use checksums |
fc33324fa08f645fcec4c82a004baa4c502e96a4500e37c3476c188e532b9354
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for Algomancy 0.10.0
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.