Browse / Invoicing and finance
Meteroid
Open-source subscription and usage-based billing with an official REST API and a hosted cloud.
Meteroid meters usage events, models plans (flat, tiered, usage-based, hybrid), manages subscriptions and issues invoices and credit notes. The Rust monorepo self-hosts with Docker Compose or Helm under AGPL-3.0; Meteroid Cloud charges a share of managed revenue. Customers, plans, subscriptions, invoices and events are all exposed over a bearer-token REST API.
- I sell a SaaS or API with usage-based pricing and want billing I own rather than a percentage-of-revenue vendor
- I want my agent to create customers and subscriptions and pull invoices from my product's backend
- AGPL-3.0 on the self-hosted edition
- Self-host needs Postgres, Kafka and ClickHouse; the compose file is described as minimal for testing
- Cloud pay-as-you-go is 0.5% of managed revenue, which is a different cost shape from a flat plan
Last activity Aug 31, 2026. Fit: adaptable 2, operable 3.
Editions
Open Source (self-hosted) · Free open source
- Clone
git clone https://github.com/meteroid-oss/meteroid - ImageContainer
Cloud sandbox · Free closed source
- HostedOpen the hosted app
Cloud pay-as-you-go · Free closed source
- HostedOpen the hosted app
Cloud volume plan · €219 per month closed source
- HostedOpen the hosted app
Enterprise · Free closed source
No distribution recorded.
Adaptable: what is yours to change
Make it yours
Config only20 things to edit
Self-host from docker/deploy with a .env: secrets, API listen addresses, Postgres, Kafka and ClickHouse connections, SMTP and optional OAuth for Google, HubSpot and Pennylane. Pricing models, plans and metrics are data you create in the app or over the API, not files.
- Env vars
JWT_SECRETINTERNAL_API_SECRETSECRETS_CRYPT_KEYMETEROID_API_EXTERNAL_URLMETEROID_REST_API_EXTERNAL_URLMETEROID_PUBLIC_URLDATABASE_URLKAFKA_BOOTSTRAP_SERVERSCLICKHOUSE_HTTP_ADDRESSOBJECT_STORE_URIOPENEXCHANGERATES_API_KEYMAILER_SMTP_HOSTMAILER_FROMOAUTH_GOOGLE_CLIENT_IDOAUTH_HUBSPOT_CLIENT_IDOAUTH_PENNYLANE_CLIENT_IDSVIX_JWT_SECRET- Config files
.envdocker/deploy/docker-compose.ymlk8s/meteroid- Prompt files
- none
- Accounts you need
- Stripe (for card collection, optional)Meteroid Cloud account (cloud editions)OpenExchangeRates (multi-currency, optional)
Source
- github.com/meteroid-oss/meteroid
- AGPL-3.0 license
- Last commit Aug 31, 2026
- 1,227 stars
Operable: what an agent can drive
Interface
OfficialAPIpublished by the builderremote or local
How an agent can drive an Operable Listing, in five levels: native (built for the agent as the primary interface), official (the Builder ships an agent interface), wrapped (a third party wraps the software's API), config (an agent can only drive it by editing files), gui (screen control only). An interface is official only when it is published by the same organization that ships the software. GUI-level Listings are allowed and sorted last.
Reach
Partial coverage. 8 of 11 jobs reachable through the stated interface.
| Job | Through the interface | Evidence |
|---|---|---|
| Ingest usage events and define billable metrics | Reachable | API tags Events, Metrics & Usage; spec/api/v1/openapi.json |
| Model plans and pricing | Reachable | API tags Plans, Products, Features |
| Subscription lifecycle (create, upgrade, cancel) | Reachable | API tag Subscriptions |
| Invoices and credit notes | Reachable | API tags Invoices, Credit Notes |
| Entitlements | Reachable | API tag Entitlements |
| Trials, coupons and add-ons | Reachable | API tags Coupons, Add-ons |
| Customer management | Reachable | API tag Customers |
| Checkout and payment collection | Reachable | API tag Checkout Sessions; Stripe connector in repo |
| Quotes (CPQ) | Undetermined | README lists Quotes as a feature; no Quotes tag seen in the API reference index |
| Customer self-serve portal | Not reachable | portal is a hosted UI for end customers, not an API surface |
| Insights and reporting | Not reachable | README marks Insights & Reporting 'Coming soon' |
Code stack
- Languages
- RustTypeScript
- Frameworks
- tonic (gRPC)React
- Package manager
- cargo
- Database
- PostgreSQLClickHouseKafka
- Hosting target
- Docker ComposeKubernetes (Helm)
- Built
- Unknown (recorded, never ranked)
Skills
Repo tooling for contributors adding payment and tax providers to Meteroid.
- Kind
- contributor
- Paths
.claude/skills/*/SKILL.md
Evidence and confidence
| Field | Where it was seen | Confidence |
|---|---|---|
| formFactor | web app plus gRPC and REST APIs; docker/deploy in repo | 90% |
| executionModel | billing engine, no model at runtime | 90% |
| operability | docs.meteroid.com/api-reference published by the Builder; OpenAPI in spec/api/v1/openapi.json | 90% |
| effort | .env.example in repo names the deployment surface | 80% |
| editions | meteroid.com/pricing: open source, sandbox, pay-as-you-go 0.5%, volume EUR 219/mo, enterprise | 85% |
| active | GitHub pushedAt 2026-08-31 | – |
| reach | 70% |
Open questions
- Whether the self-hosted REST API is at parity with api.meteroid.com (the reference documents the cloud base URL)
- Quotes exposure over the API
Sources
- github.com/meteroid-oss/meteroid sourcing:invoicing-finance:github
- docs.meteroid.com/api-reference analysis:invoicing-finance
- meteroid.com/pricing analysis:invoicing-finance