TokenTally: All-in-One AI Cost Calculator

TokenTally is an open source web application designed to empower developers, researchers, and businesses to estimate and compare costs across various AI and Large Language Model (LLM) APIs. In today’s rapidly evolving AI landscape, TokenTally provides a real-time, user-friendly interface to help you make informed decisions when integrating services like OpenAI, Claude, Gemini, DALL-E, Whisper, Cohere, and Perplexity.ai into your projects.

Features

• Multiple Model Support: Calculate costs for models such as OpenAI, Claude, Gemini, DALL-E, Whisper, Cohere, and Perplexity.ai.
• Interactive Calculators: Easily input token counts and view detailed cost breakdowns.
• Comprehensive Pricing Tables: Always up-to-date pricing details across supported AI models.
• Visual Comparisons: Charts and graphs to compare costs across different services.
• Quick Calculations: Utilize the command palette (Cmd+K) for rapid cost estimates.
• Responsive Design: Enjoy a fully responsive layout that works seamlessly on both desktop and mobile devices.
• Dark Mode Support: Toggle between light and dark themes for a comfortable user experience.
• Dynamic OG Images: Automatically generated Open Graph images enhance social media sharing.
• Toast Notifications: User-friendly notifications via Sonner for improved interactivity.
• Extended Provider Catalog: Compare curated pricing for providers like Mistral, Groq, Midjourney, and OpenRouter across tokens, subscriptions, and credit bundles.
• Provider Comparison Dashboard: Contrast providers side-by-side with token stats, context windows, curated marketplace plans, and quick pairing presets.

Project Structure Overview

TokenTally follows a modern Next.js 15+ architecture using the App Router. Below is a breakdown of the project’s structure along with the most significant files:

/app                  - Main application directory with pages and layout components (e.g., /app/page.tsx for the landing page)
/components           - Reusable React components (Calculators, Toast Notifications, Charts, etc.)
/config               - Application configuration including pricing data
/config/pricing.ts    - Source of truth for all pricing and model definitions
/public               - Static assets including images, icons, and dynamic OG images
/utils                - Utility functions for API integrations and cost calculations
/package.json         - Manages project dependencies and scripts (see updated snippet below)
/next.config.js       - Next.js configuration file

---

Installation & Usage

Follow these steps to set up and run TokenTally locally:

1. Clone the Repository:

   git clone https://github.com/yourusername/TokenTally.git
   cd TokenTally

2. Install Dependencies:

   Using npm:

   npm install

   Or using Yarn:

   yarn install

3. Run the Development Server:

   npm run dev

   or

   yarn dev

   Open your browser and navigate to http://localhost:3000.

4. Build for Production:

   npm run build
   npm start

   or

   yarn build
   yarn start

Pricing Data Automation

• npm run pricing:update refreshes generated/pricing.json with the latest provider data and stores a dated snapshot in generated/history/.
• npm run pricing:update:dry runs the pipeline without writing files—helpful for CI or local smoke tests.
• npm run pricing:test validates the OpenAI parser against the stored fixture before hitting live endpoints.
• The build step triggers the updater automatically through the prebuild script; remove or comment out the hook if you need to bypass it temporarily.

---

Contributing

TokenTally is an open source project and welcomes contributions from the community. To contribute:

1. Fork the Repository

2. Create a Feature Branch:

   git checkout -b feature/YourFeature

3. Commit Your Changes:

   git commit -m "Add some feature"

4. Push to Your Branch:

   git push origin feature/YourFeature

5. Open a Pull Request for review.

Please ensure your contributions adhere to our coding standards and include relevant tests.

---

Acknowledgements

TokenTally is powered by a collection of outstanding services and libraries:

• Vercel – Hosting and deployment platform.
• v0 – Innovative technology and UI generation.
• Next.js – The React framework for building modern web applications.
• RepoBeats – Provides insightful project analytics.
• ShadCN UI – A set of modern UI components for rapid development.

Project Stats

License

This project is licensed under the MIT License. See the LICENSE file for details.