Craitor is a lightweight, configurable AI token and cost estimation tool built with PHP. It scans folders, estimates token usage, compares multiple AI models, and visualizes cost projections.
This tool is designed for developers, AI experimenters, and automation builders who want to understand approximate AI usage cost before running prompts.
Perfect for:
- AI assistants (Picoclaw, agents, automation)
- Code refactoring experiments
- Prompt engineering tests
- Repository analysis
- Dataset ingestion planning
- Budget estimation
- 📂 Folder scanning with recursive file discovery
- 🔎 Configurable file extensions (
extension.txt) - 🚫 Ignore folders (
ignore_folder.txt) - 🤖 Multi-model comparison (
model_list.csv) - 💰 Cost calculation per million tokens
- 📊 Chart.js visualization
- 📄 JSON export for analytics
- ⚡ Lightweight — no database required
- 🛠 Fully configurable without editing PHP code
Craitor uses a simple approximation:
tokens ≈ characters / 4
This provides a practical estimate typically within ±15–25% of real tokenizer counts, which is sufficient for budgeting and planning purposes.
Craitor/
├── index.php
├── model_list.csv
├── extension.txt
├── ignore_folder.txt
└── result_json/
Defines AI models and pricing (per million tokens).
model,input_cost_per_million,output_cost_per_million
GPT-4o,5,15
Claude 3.5 Sonnet,3,15
DeepSeek Chat,0.27,1.10
You can customize or add your own providers.
Controls which file types are scanned.
txt
php
html
md
json
js
css
py
One extension per line. No dot required.
Folders or paths to exclude from scanning.
node_modules
vendor
.git
cache
logs
tmp
If a path contains any entry, it will be ignored.
- Clone the repository:
git clone https://github.com/dtr-kalfer/craitor.git
- Place inside your PHP server directory:
/var/www/html/craitor
-
Ensure PHP has permission to write JSON reports.
-
Open in browser:
http://localhost/craitor
Before running prompts:
- Code explanation
- Refactoring
- Documentation generation
- Automation agents
You can estimate total cost.
Estimate how expensive it would be to:
- Feed an entire Git repository into an LLM
- Run code summarization
- Perform AI audits
Compare cost differences between:
- Full context
- Reduced context
- Summarized inputs
Predict operational costs for:
- Daily automation
- Scheduled jobs
- AI pipelines
- Agent workflows
Craitor produces:
- Model comparison table
- Cost visualization chart
- Downloadable JSON report
JSON output can be used with:
- Chart.js
- Dashboards
- Analytics tools
- Automation scripts
AI experimentation often fails because developers do not know the cost beforehand.
Craitor helps answer:
“How expensive will this prompt or project be?”
before you spend real money.
Possible enhancements:
- Monthly cost projection
- Per-file token breakdown
- Token heatmap visualization
- ZIP upload analysis
- Accurate tokenizer integration
- Multi-folder comparison
- CLI version
This project was inspired by the powerful AI agent workflow made possible through Picoclaw.
Charts and data visualization are implemented using Chart.js, an open-source JavaScript charting library.
- Picoclaw: https://github.com/sipeed/picoclaw
- Chart.js: https://www.chartjs.org/
Special thanks to the open-source community for providing amazing tools that make AI projects possible.
This project is licensed under the MIT License — see the LICENSE file for details.
This project was created to help developers explore AI safely and thoughtfully.
May it help you in your AI journey.
Craitor — AI Cost Estimator
Copyright (c) 2026 Ferdinand Tumulak / License: MIT