modbender Aoineco Ledger โ AI Agent Financial Tracking Engine
Version: 1.0.0
Author: Aoineco & Co.
License: MIT
Tags: finance, expense-tracking, budget, roi, bootstrap, multi-agent, accounting
Description
Financial tracking engine built for AI agents operating on extreme budgets. Tracks every API call, gas fee, and revenue stream with per-agent cost attribution. Native support for the $7 Bootstrap Protocol.
Rebuilt from agentledger (Node.js) into Python with major enhancements for multi-agent squads and micro-budget operations.
Core metric: Intelligence per Dollar (IPD) โ how many operations you get per cent spent.
Problem
AI agents spend money (API calls, gas fees, subscriptions) but rarely track it. When you're running a 9-agent squad on a $7 seed budget, every fraction of a cent matters. You need:
- Real-time visibility into burn rate and runway
- Per-agent cost attribution (who's spending what?)
- Budget alerts BEFORE you overspend
- Revenue tracking to measure actual ROI
Features
| Feature | Description |
|---|---|
| Transaction Logging | Log expenses, revenue, API costs, gas fees with one-liner methods |
| $7 Bootstrap Metrics | Seed tracking, ROI%, runway days, daily burn rate, IPD |
| Per-Agent Cost Attribution | Track spending by squad member (oracle, blue-sound, etc.) |
| Budget Alerts | Set limits per category/period โ warns at 80%, blocks at 100% |
| Category System | Pre-configured for AI ops: API/LLM, Gas/Blockchain, Revenue/Gig, etc. |
| CSV/JSON Export | Full transaction export for tax, audit, or analysis |
| JSONL Storage | Append-only transaction log โ fast, corruption-resistant |
| Period Filtering | Query by today, this-week, this-month, this-year, or all |
Quick Start
from ledger_engine import AoinecoLedger
ledger = AoinecoLedger()
# Log API cost
ledger.log_api_cost(0.0042, "Google", "gemini-3-flash", tokens_used=150000, agent="oracle")
# Log gas fee
ledger.log_gas(0.0003, chain="base", tx_hash="0xabc123", agent="blue-sound")
# Log revenue
ledger.log_revenue(0.01, "MoltLaunch", "Tier-1 Intel Report", category="Revenue/Gig")
# Set budget
ledger.set_budget("API/LLM", limit=3.00, period="daily")
# Check $7 Bootstrap metrics
metrics = ledger.get_bootstrap_metrics()
# โ Seed: $7.00, Burn: $0.02/day, Runway: 300 days, IPD: 257.5 ops/$
Bootstrap Metrics Output
๐ฐ Seed Amount: $7.00
๐ Total Revenue: $0.0150
๐ Total Expenses: $0.0233
๐ค API/LLM Cost: $0.0230
๐ต Net Profit: $-0.0083
๐ ROI: -0.1%
๐ Remaining Balance: $6.9917
๐ฅ Daily Burn Rate: $0.0233/day
โฑ๏ธ Runway: 300 days
๐ง IPD: 257.5 ops/$
Pre-Configured Categories
API/LLMโ OpenAI, Anthropic, Google API costsGas/Blockchainโ On-chain transaction feesRevenue/Gigโ MoltLaunch gig incomeRevenue/DeFiโ Meteora, LP yieldsRevenue/Musicโ claw.fm royaltiesInfrastructure,Marketing,Tools,Subscriptions,Other
File Structure
aoineco-ledger/
โโโ SKILL.md # This file
โโโ scripts/
โโโ ledger_engine.py # Main engine (zero external dependencies)
Zero Dependencies
Pure Python 3.10+. No pip install needed. Designed for the $7 Bootstrap Protocol โ every byte counts.