{"id":41150682,"url":"https://github.com/valmi-io/value","last_synced_at":"2026-01-22T19:06:54.663Z","repository":{"id":152051152,"uuid":"598595038","full_name":"valmi-io/value","owner":"valmi-io","description":"⚡ \"Value\"  - https://value.valmi.io . Valmi Value is Outcome-based billing and payments infrastructure for AI agents. Meter usage, configure flexible pricing, and track costs \u0026 profitability - so you can focus on building great AI products.","archived":false,"fork":false,"pushed_at":"2025-12-17T19:02:03.000Z","size":54323,"stargazers_count":165,"open_issues_count":1,"forks_count":15,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-12-21T07:22:15.557Z","etag":null,"topics":["agentic-ai","agents","ai","ai-agents","crewai","langgraph","n8n","open-source"],"latest_commit_sha":null,"homepage":"https://www.valmi.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/valmi-io.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-02-07T12:40:44.000Z","updated_at":"2025-12-17T19:02:07.000Z","dependencies_parsed_at":null,"dependency_job_id":"8d256a1e-a7f5-46df-bce1-70dd3199a4ab","html_url":"https://github.com/valmi-io/value","commit_stats":null,"previous_names":["valmi-io/value"],"tags_count":159,"template":false,"template_full_name":null,"purl":"pkg:github/valmi-io/value","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valmi-io%2Fvalue","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valmi-io%2Fvalue/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valmi-io%2Fvalue/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valmi-io%2Fvalue/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/valmi-io","download_url":"https://codeload.github.com/valmi-io/value/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valmi-io%2Fvalue/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28668841,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-22T17:07:18.858Z","status":"ssl_error","status_checked_at":"2026-01-22T17:05:02.040Z","response_time":144,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentic-ai","agents","ai","ai-agents","crewai","langgraph","n8n","open-source"],"created_at":"2026-01-22T19:02:31.905Z","updated_at":"2026-01-22T19:06:54.658Z","avatar_url":"https://github.com/valmi-io.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n   \u003ca href=\"https://www.valmi.io\"\u003e\u003cimg src=\"images/logo.png\" alt=\"Value Platform Logo\" width=\"200\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n \u003ca href=\"https://www.valmi.io\"\u003e\u003cimg src=\"https://img.shields.io/badge/☁_Cloud-ec4800?style=for-the-badge\" alt=\"Cloud\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.valmi.io/docs/introduction\"\u003e\u003cimg src=\"https://img.shields.io/badge/📚_Docs-6366f1?style=for-the-badge\" alt=\"Docs\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.valmi.io/blog/\"\u003e\u003cimg src=\"https://img.shields.io/badge/📝_Blog-ec4899?style=for-the-badge\" alt=\"Blog\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.valmi.io\"\u003e\u003cimg src=\"https://img.shields.io/badge/📝_Website-ec4900?style=for-the-badge\" alt=\"Website\"\u003e\u003c/a\u003e\n     \u003ca href=\"https://github.com/valmi-io/value\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/valmi-io/value?style=for-the-badge\" alt=\"GitHub stars\"\u003e\u003c/a\u003e\n   \u003ca href=\"https://hub.docker.com/repositories/valmiinfra\"\u003e\u003cimg src=\"https://img.shields.io/badge/🐳_Docker-0ea5e9?style=for-the-badge\" alt=\"Docker Hub\"\u003e\u003c/a\u003e\n  \n  ⭐ *Consider giving us a Github star! Your support helps us add new, exciting features.*\n\u003c/p\u003e\n\n   \u003cdiv align=\"center\"\u003e\n\n\n\u003c/div\u003e\n\n# Value Platform\n\nOutcome-based billing and payments infrastructure for AI agents. Meter usage, configure flexible pricing, and track profitability, so you can focus on building great AI products.\n\n## Overview\n\nValue Platform handles metering, pricing, billing, and revenue tracking for AI agents:\n\n- **AI-Native Metering** - Track tokens, LLM calls, API usage, and outcomes with minimal code\n- **Flexible Pricing** - Fixed-Fee, Usage-based, tiered, per-action, per-outcome, or any combination\n- **Cost Attribution** - Automatically allocate costs across LLM providers, APIs, and compute\n- **Revenue Insights** - Real-time profitability tracking per agent and per customer\n\n## Start Tracking Your AI Agents\n\nChoose your deployment option, and start metering in minutes:\n\n---\n\n### ☁️ Option 1: Use Value Cloud\n\nThe fastest way to get started - no infrastructure to manage.\n\n**Step 1:** Sign up at 👉 **[value.valmi.io](https://www.value.valmi.io/)**\n\n**Step 2:** Install the SDK and start tracking:\n\n```bash\npip install value-python\n```\n\n```python\nfrom value import initialize_sync\n\nclient = initialize_sync(agent_secret=\"your_agent_secret\")\n\nwith client.action_context(user_id=\"user_123\", anonymous_id=\"anon_456\") as ctx:\n    ctx.send(\n        action_name=\"document_processing\",\n        **{\"value.action.description\": \"Processing invoice\", \"document_type\": \"invoice\"},\n    )\n```\n\nThat's it! Your agent data flows to Value Cloud automatically.\n\n---\n\n### 🏠 Option 2: Self-Hosted Deployment\n\nRun Value Platform on your own infrastructure for complete control.\n\n**Step 1:** Start the services\n\n```bash\n# Prerequisites: Docker \u0026 Docker Compose, Make\n\n# Configure environment\ncp value-engine/.env.example value-engine/.env\ncp value-control-plane-backend/.env.example value-control-plane-backend/.env\n\n# Start all services\nmake value-up\n```\n\n**Step 2:** Install the SDK and point to your local instance:\n\n```bash\npip install value-python\n```\n\n```bash\n# Set environment variables\nexport VALUE_BACKEND_URL=http://localhost:8200\nexport VALUE_OTEL_ENDPOINT=http://localhost:4317\n```\n\n```python\nfrom value import initialize_sync\n\nclient = initialize_sync(agent_secret=\"your_agent_secret\")\n\nwith client.action_context(user_id=\"user_123\", anonymous_id=\"anon_456\") as ctx:\n    ctx.send(action_name=\"document_processing\", **{\"document_type\": \"invoice\"})\n```\n\n**Step 3:** Access your dashboard\n\n| Service           | URL                        |\n| ----------------- | -------------------------- |\n| Value UI          | http://localhost:3000      |\n| Control Plane API | http://localhost:8200/docs |\n| Engine API        | http://localhost:8000/docs |\n| Celery Flower     | http://localhost:5555      |\n\n```bash\n# Stop services\nmake value-down\n\n# Clean all data volumes\nmake value-clean-volumes\n```\n\n---\n\n📖 See [`sdks/`](./sdks/) for detailed SDK documentation.\n\n## Architecture\n\n```\n┌─────────────────┐                              ┌─────────────────┐\n│   Value SDK     │─────────────────────────────▶│  Value Engine   │\n│  (Python/Node)  │                              │  (Processing)   │\n└─────────────────┘                              └────────┬────────┘\n                                                          │\n                                                          ▼\n┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐\n│    Value UI     │◀───▶│  Control Plane   │◀───▶│   Data Store    │\n│   (Dashboard)   │     │      (API)       │     │                 │\n└─────────────────┘     └──────────────────┘     └─────────────────┘\n```\n\n## Screenshots\n\n### Dashboard\n\n![Dashboard](images/dashboard.png)\n\n### Agents Live Data\n\n![Agents Live Data](images/agents_live_data.png)\n\n### P\u0026L Analysis\n\n![P\u0026L Analysis](images/pnl_analysis.png)\n\n### Pricing Simulation\n\n![Pricing Simulation](images/pricing_simulation.png)\n\n## Services\n\n| Service           | Description                                      | Port |\n| ----------------- | ------------------------------------------------ | ---- |\n| **Value UI**      | Web dashboard for monitoring and management      | 3000 |\n| **Control Plane** | REST API for configuration and data management   | 8200 |\n| **Value Engine**  | Data processing pipelines and task orchestration | 8000 |\n\n## Examples\n\n| Example                                                                  | Description            |\n| ------------------------------------------------------------------------ | ---------------------- |\n| [basic_sync.py](./examples/python/basic_sync.py)                         | Synchronous SDK usage  |\n| [basic_async.py](./examples/python/basic_async.py)                       | Async SDK usage        |\n| [gemini_instrumentation.py](./examples/python/gemini_instrumentation.py) | Auto-instrument Gemini |\n| [pipeline_simulation.py](./examples/python/pipeline_simulation.py)       | Full AI pipeline demo  |\n\nSee [`examples/`](./examples/) for more integration examples.\n\n## License\n\nThis repository contains components under different licenses:\n\n- **MIT**: `sdks/`, `examples/`, `seed-dummy-data/`\n- **ELv2**: `value-control-plane-backend/`, `value-engine/`, `value-ui/`\n\nSee [LICENSE](./LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvalmi-io%2Fvalue","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvalmi-io%2Fvalue","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvalmi-io%2Fvalue/lists"}