Skip to main content

Consta

Evidence-first briefs for OSS contribution decisions. Given a question and a target repository, Consta retrieves cited evidence (issues, commits, docs, adjacent projects) and optionally synthesizes a short summary. Humans keep the final call.

pip install consta
uvx consta assess -q "…" -r pytorch/pytorch -p torch/masked --no-synthesis

Consta is Latin, Italian and Spanish for "it is on record, it stands as fact". The tool reports what the evidence establishes and leaves the verdict to you.

Architecture: ARCHITECTURE.md

Product backlog and delivery dates live in the private Arraxis planning workspace, not in this tree.

Install (dev)

pip install -e ".[dev]"      # CLI + tests
pip install -e ".[dev,web]"  # + Flask UI (consta-web)

Configure

Copy the template and fill in secrets (never commit .env):

cp .env.example .env
Variable Required Purpose
CONSTA_GITHUB_TOKEN Yes (live runs) Fine-grained PAT or classic public_repo
CONSTA_LLM_PROVIDER Optional huggingface, openai or anthropic (code default: anthropic; .env.example sets huggingface)
CONSTA_HF_TOKEN Optional Synthesis via the Hugging Face router; also used for gated Hub discussions
CONSTA_OPENAI_API_KEY Optional Synthesis via OpenAI
CONSTA_ANTHROPIC_API_KEY Optional Synthesis via Anthropic
CONSTA_LLM_MODEL Optional Override the provider's default model

Web UI

pip install -e ".[web]"
consta-web
# http://127.0.0.1:5050 — form, sample cases, cited report (Bootstrap)

Not sure what to try? Pick a card on the home page — six scenarios across pytorch, numpy, and sklearn (eval/sample_cases.yaml).

See docs/WEB_UI.md and docs/STATUS.md.

Commands

consta ping
consta list-profiles

consta assess \
  --question "Is reviving torch.masked worth an upstream contribution?" \
  --repo pytorch/pytorch \
  --path torch/masked \
  --ecosystem pytorch \
  --tier 2 \
  --output report.md

Flags: --no-synthesis, --json, --allow-stale-profile.

Test (mandatory before claiming done)

./scripts/verify.sh

See docs/VERIFICATION.md.

pytest -v
CONSTA_RUN_LIVE=1 pytest tests/test_live.py -v
consta ping

Ecosystem profiles

Profile Repo Use case
pytorch pytorch/pytorch torch.masked, torch.nested, …
numpy numpy/numpy numpy.ma, NEPs, missing-data semantics
sklearn scikit-learn/scikit-learn SLEPs, metadata routing, estimator API
consta list-profiles
./scripts/run_sample_assessments.sh   # needs .env
python scripts/validate_reports.py

GitHub Action

action/action.yml posts a sticky evidence comment on issues:

on:
  issues:
    types: [opened]
permissions:
  issues: write
jobs:
  brief:
    runs-on: ubuntu-latest
    steps:
      - uses: sulimovp/consta/action@main
        with:
          github-token: ${{ secrets.GITHUB_TOKEN }}
          ecosystem: pytorch

License

Apache-2.0. No CLA.

Metadata

Release files for consta 0.2.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 consta 0.2.0
File Size Uploaded Provenance Actions
consta-0.2.0.tar.gz 432.3 kB With provenance Details for consta-0.2.0.tar.gz

Built distribution (wheel)

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

Total release size: 538.5 kB

Release files / consta-0.2.0.tar.gz

Download URL consta-0.2.0.tar.gz
Size 432.3 kB
Tags Source
SHA-256 checksum
How to use checksums
c6799e43e2f5e29a90d8baa3a232c70837685f1a769d8725cd6f5beb73a36c68
BLAKE2b-256 checksum
How to use checksums
02c4b307d89305516355818f0394cd50434c087266be2a5c860204296c5d481d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 3, 2026.

Transparency log

Release files / consta-0.2.0-py3-none-any.whl

Download URL consta-0.2.0-py3-none-any.whl
Size 106.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
82f7fe22f045a8826978860782fc8cd6b04eb14269e24d416b65682c95dadbdd
BLAKE2b-256 checksum
How to use checksums
159600e4b051c2d2c3016d824eda180eee4176dfe0e5d45e423ce20c2192b69c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 3, 2026.

Transparency log

Security for consta 0.2.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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for consta-0.2.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 3, 2026.

Transparency log

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.

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files Full provenance

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