Skip to main content

orama

όραμα

Greek; noun

Vision, goal.

Declarative, metadata-driven charting library for Python.

orama produces Plotly figures and HTML KPI indicator widgets from structured Polars DataFrames using a pluggable strategy pattern, fields-metadata-driven field discovery, therismos-based query descriptors, and composable color strategies (using polychromos and armonia).

KPI indicators produced by orama

Full documentation: https://orama.readthedocs.io/en/latest · Tutorial


A chart in a dozen lines

fields_metadata = MetadataExtractor().extract(SalesRecord)          # what each field means

strategy = BarChartStrategy(                                          # describe the chart
    fields_metadata=fields_metadata,
    category_variables=["region"],
    aggregation=Aggregation(name="total", function="sum", field="revenue"),
)
dfs = run_my_queries(strategy.get_query_params())                    # you run the query, anywhere

view = strategy.build(dfs, NullTranslations(), theme)                # figure + caption + description
html = view.to_html(animate=True)                                    # optional GSAP reveal

orama never touches your data: a strategy tells you which query to run and draws what you return. See the Quick Start for a complete, runnable version.


Installation

pip install orama
Extra Installs
orama[web] WTForms (web binding for orama.web: FigureView, IndicatorWebView)
orama[demo] orama[web] + Flask, Flask-WTF
orama[docs] MkDocs Material and mkdocstrings, to build the documentation (uv run --extra docs mkdocs serve)
orama[test] pytest, mypy, ruff, tox and Playwright. Browser tests: uv run --extra docs pytest -m e2e --no-cov (docs is needed by the documentation-site tests)

License

MIT

Metadata

Release files for orama 1.6.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for orama 1.6.0
File Size Uploaded Provenance Actions
orama-1.6.0.tar.gz 128.9 kB Without provenance Details for orama-1.6.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for orama 1.6.0
File Interpreter ABI Platform Actions
orama-1.6.0-py3-none-any.whl Python 3 none any Details for orama-1.6.0-py3-none-any.whl

Total release size: 255.4 kB

Release files / orama-1.6.0.tar.gz

Download URL orama-1.6.0.tar.gz
Size 128.9 kB
Tags Source
SHA-256 checksum
How to use checksums
4c2a34deaf1a7002638ce0449fc639e3e101ae4ed20b88feb2582b0e69ebd537
BLAKE2b-256 checksum
How to use checksums
7af74e33eac678750512106159b4e8fa2bfdd8645e78e4304cd245e30b999db8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.25 {"installer":{"name":"uv","version":"0.11.25","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":null}

Release files / orama-1.6.0-py3-none-any.whl

Download URL orama-1.6.0-py3-none-any.whl
Size 126.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4a4c6c2c0845d9b0ab224f8b5b80bf15aa45fcef8390aabd9d287bb43299ea34
BLAKE2b-256 checksum
How to use checksums
c40c349fcc47770c61d8a1ff716f6bc7344dd6ab3b8d5fc367ef4c1d5fe60c93
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.25 {"installer":{"name":"uv","version":"0.11.25","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":null}

Security for orama 1.6.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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page