Skip to main content

ampere

Tooling to track and visualize engagement with the mrpowers-io organization


site


Installation

ampere is available as a CLI tool and a self-hosted web application (dagster scheduled jobs, fastapi api, and plotly dash frontend)

to use the CLI:

uv steps:

  1. create a virtual env via uv venv
  2. add the package to the virtual env via uv add ampere-meter
  3. see available cli commands via uv run ampere --help or source .venv/bin/activate && ampere --help

pip steps:

  1. install the package via pip install ampere-meter
  2. see available cli commands via ampere --help

[WIP] to use the web application:

disclaimer: this is a work in progress and init scripts are not yet available

  1. clone the repository
  2. configure required environment variables in .env - refer to .env.example
  3. run uv sync --all-extras to build the full .venv
  4. docker compose up --build to start the api, backend, and frontend services

API

documentation available at https://api-ampere.jeffbrennan.dev/docs

currently supports three endpoints:

  1. /repos - list of current repos
  2. /feed - recent github activity (stars, issues, prs, etc.)
  3. /downloads - download statistics (hourly, daily, weekly, monthly)

Metrics

Data

data model

Sources

GitHub REST API

updated 4 times a day

  • repos
  • stars
  • issues
  • commits
  • forks
  • releases
  • pull requests

Bigquery PyPi Downloads

updated daily

  • python release downloads grouped by package version, python version, operating system, cloud platform

additionally gets download statistics for core project dependencies

  • pyspark
  • deltalake

Pages

home

Weekly github metrics

  • stars
  • issues
  • commits

downloads

Weekly download statistics. Currently only includes python release downloads

  • overall
  • package version
  • python version
  • cloud platform

feed

scrolling, color-coded table of recent organization activity

  • stars
  • issues
  • commits
  • forks
  • pull requests

issues

summary and details of current issues

  • summary: open issues, median issue age, issues closed this month
  • details: repo, author title, body, date, days old, comments

network stargazers

each star is a node, and people who have starred multiple repositories are connected to each other density of lines indicates common groups of stars edges of each cluster indicate users who have only starred one repository

network followers

each user is a node, internal (another organization user) followers and following are connected includes any user with a record in one of these tables:

  • stg_stargazers
  • stg_forks
  • stg_commits
  • stg_issues
  • stg_pull_requests

blue edges are a mutual connection, grey edges are one-way color of node indicates number of followers

percentage of internal followers and following computed against user total followers and following

status

data quality page indicating the last time each data source was updated and the number of records in each table

about

repo summaries and links


Tech Stack

This project is build with an open source (d)ata stack:


TODOs

  • dark mode
  • page load speed
  • mobile improvements
  • create API
  • create init scripts for first time setup
  • add tests for API, CLI, and web application
  • and github actions to run tests, linting checks
  • publish to pypi
  • add ampere to mrpowers-io organization

Metadata

Release files for ampere-meter 0.1.4

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

Source distribution (sdist)

Source distribution for ampere-meter 0.1.4
File Size Uploaded Provenance Actions
ampere_meter-0.1.4.tar.gz 918.1 kB With provenance Details for ampere_meter-0.1.4.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for ampere-meter 0.1.4
File Interpreter ABI Platform Actions
ampere_meter-0.1.4-py3-none-any.whl Python 3 none any Details for ampere_meter-0.1.4-py3-none-any.whl

Total release size: 1.4 MB

Release files / ampere_meter-0.1.4.tar.gz

Download URL ampere_meter-0.1.4.tar.gz
Size 918.1 kB
Tags Source
SHA-256 checksum
How to use checksums
c6a8cc8b949eed3a847876b242790aadabaed9f2b1ffb0a2babf6a6c61f91ff2
BLAKE2b-256 checksum
How to use checksums
02f66c6fda5f3311678db90b4e195a1b1b0b82b64f924bfcd6457badf624ccc9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.12.8

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 Feb 16, 2025.

Transparency log

Release files / ampere_meter-0.1.4-py3-none-any.whl

Download URL ampere_meter-0.1.4-py3-none-any.whl
Size 491.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
46efbfe39168e63f8aa3d3611a83e84addd5b847bfa05dbb3860249214fb3929
BLAKE2b-256 checksum
How to use checksums
a92582dda58792231a54b569b81d0883f6230eb959939fee54dfd9a065a33625
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.12.8

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 Feb 16, 2025.

Transparency log

Security for ampere-meter 0.1.4

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 ampere_meter-0.1.4.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 Feb 16, 2025.

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.

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