🎩 You're Invited:Meet the Socket team at Black Hat in Las Vegas, August 3-6.RSVP
Sign In

aicost-cli

Package Overview
Dependencies
Maintainers
1
Versions
3
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

aicost-cli

Terminal-based AI API Cost Calculator, Converter & Recommender. Compare providers, convert currencies, and get model recommendations.

pipPyPI
Version
1.1.1
Weekly downloads
20
-47.37%
Maintainers
1
Weekly downloads
 

AI-Cost-CLI

PyPI License: MIT Python 3.9+ MCP Registry

A terminal-based calculator and recommendation engine for AI API costs. Supports multiple providers, local currency conversion, and automated pricing updates.

Preview: Direct vs. Aggregator Comparison

Compare the effective cost of using models directly vs. through gateways like OpenRouter, including platform fees.

                    Comparison: gpt-4o vs openrouter/gpt-4o                     
┏━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Attribute        ┃             gpt-4o              ┃    openrouter/gpt-4o    ┃
┡━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ Provider         │             OpenAI              │       OpenRouter        │
├──────────────────┼─────────────────────────────────┼─────────────────────────┤
│ Source           │             Direct              │       Aggregator        │
├──────────────────┼─────────────────────────────────┼─────────────────────────┤
│ Platform Fee     │              0.0%               │          5.5%           │
├──────────────────┼─────────────────────────────────┼─────────────────────────┤
│ Type             │              text               │          text           │
├──────────────────┼─────────────────────────────────┼─────────────────────────┤
│ Input Cost       │        111.4775 TRY (1M)        │    117.6088 TRY (1M)    │
├──────────────────┼─────────────────────────────────┼─────────────────────────┤
│ Output/Unit Cost │        445.9100 TRY (1M)        │    470.4350 TRY (1M)    │
└──────────────────┴─────────────────────────────────┴─────────────────────────┘

Supported Models

Text Models

ModelProviderInput/1MOutput/1MTags
Claude Opus 4.7Anthropic$5.00$25.00reasoning, coding, vision, agentic
GPT-5.5OpenAI$5.00$30.00multimodal, coding, agentic
GPT-5.5 ProOpenAI$30.00$180.00precision, enterprise, agentic
Claude Sonnet 4.6Anthropic$3.00$15.00coding, fast, general
GPT-4oOpenAI$2.50$10.00reasoning, coding, vision
Gemini 3.1 ProGoogle$2.00$12.00long-context, multimodal
DeepSeek R1DeepSeek$0.55$2.19reasoning, coding, smart
Gemini 2.5 FlashGoogle$0.30$2.50fast, reasoning, legacy
Gemini 3.1 Flash-LiteGoogle$0.25$1.50fast, cheap, agentic
DeepSeek V3DeepSeek$0.14$0.28general, coding, cheap

Image, Video & Audio Models

ModelProviderPriceType
Imagen 4 FastGoogle$0.02/imageImage
GPT-Image-1OpenAI$0.02/imageImage
DALL-E 3OpenAI$0.04/imageImage
Imagen 4 UltraGoogle$0.06/imageImage
Veo 3 LiteGoogle$0.05/secVideo
Veo 3Google$0.40/secVideo
Lyria 3 ClipGoogle$0.04/clipMusic
Lyria 3 ProGoogle$0.08/songMusic
WhisperOpenAI$0.006/minSpeech-to-Text
TTS StandardOpenAI$15/1M charsText-to-Speech

Full list available via aicost list --currency USD

Features

  • Infrastructure Comparison: Compare Direct providers vs. Aggregators (OpenRouter) and Gateways (Portkey, LiteLLM, Martian).
  • Transparent Commissions: Automatically calculates platform fees (e.g., OpenRouter's 5.5% credit fee).
  • Direct Cost Calculation: Full breakdown of base costs and platform middle-layer fees.
  • Currency Conversion: Real-time conversion to local currencies (TRY, EUR, etc.) with offline fallback.
  • Automated Pricing: Weekly automated updates from official provider documentation.
  • MCP Server: Native support for AI agents (Cursor, Claude Desktop).

Installation

pip install aicost-cli

With MCP server support:

pip install aicost-cli[mcp]

Or from source:

git clone https://github.com/ufhouck/aicost.git
cd aicost
pip install -e .

Usage

List All Models

aicost list --currency TRY

Calculate Cost

# Text model — token-based
aicost calc claude-opus-4.7 --input 1000000 --output 500000 --currency TRY

# With platform fee breakdown (aggregators)
aicost calc openrouter/gpt-4o --input 1000000 --output 500000 --currency TRY

Output Example:

╭───────── Cost Calculation ──────────╮
│ Model: openrouter/gpt-4o            │
│ Source: Aggregator                  │
│                                     │
│ Base Cost: 316.9976 TRY             │
│ Platform Fee (5.5%): 17.4349 TRY    │
│                                     │
│ Total Cost: 334.4325 TRY            │
╰─────────────────────────────────────╯

Compare Models

aicost compare claude-opus-4.7 gpt-5.5 --currency USD

Get Recommendations

aicost recommend "fast cheap coding" --currency USD

Sync Latest Pricing

aicost sync

MCP Server

Start the Model Context Protocol server for AI agent integration:

aicost mcp

Registries

Contributing

See CONTRIBUTING.md for guidelines on how to contribute, including pricing updates, bug reports, and code contributions.

Community

License

MIT — see LICENSE for details. Developed by Ufuk Aydın.

Keywords

ai

FAQs

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts