Skip to content

Commit a58eb01

Browse files
authored
Merge pull request #25 from totalbrain/dev
Dev
2 parents d2cbd72 + 8022176 commit a58eb01

37 files changed

+729
-3
lines changed

README.md

Lines changed: 68 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,70 @@
1+
AI Token Crusher – Full Journey (From Idea to Production)
2+
3+
## Quick Links
4+
- Repository: https://github.com/totalbrain/TokenOptimizer
5+
- Live Releases: https://github.com/totalbrain/TokenOptimizer/releases
6+
- Project Board (Roadmap): https://github.com/users/totalbrain/projects/1
7+
- Product Hunt Launch (coming soon): https://www.producthunt.com/posts/ai-token-crusher
8+
- Workflow : https://github.com/totalbrain/TokenOptimizer/blob/dev/docs/Workflow.md
9+
10+
## The Story – How It All Started
11+
One day I was tired of:
12+
- Wasting thousands of tokens daily on long Python scripts and RAG documents
13+
- Copy-pasting code into ChatGPT/Claude just to remove comments and spaces
14+
- Getting rate-limited because context was too big
15+
16+
I thought: "There must be a better way."
17+
18+
So I built AI Token Crusher – an **offline desktop app that safely cuts up to 75% of tokens while keeping 100% readability for all major LLMs (Grok, GPT-4o, Claude 3.5, Llama 3.1, Gemini).
19+
20+
## What We Have Achieved So Far (Live & Working)
21+
22+
| Feature | Status | Notes |
23+
|----------------------------------------|-----------|-------|
24+
| 20+ AI-safe optimization techniques | Done | Comments, docstrings, spaces, unicode shortcuts, etc. |
25+
| Full dark UI (GitHub-style) | Done | Modern, clean, professional |
26+
| Dark / Light theme toggle | Done | Thanks to @Syogo-Suganoya |
27+
| Real-time character & savings counter | Done | Live feedback |
28+
| Load file / paste text / save output | Done | Full workflow |
29+
| 18 planned features in public roadmap | Done | Transparent project board |
30+
| Protected `main` branch | Done | Only stable code |
31+
| Active `dev` branch for contributions | Done | All PRs go here |
32+
| First community PR merged | Done | #19 – Theme toggle |
33+
| GitHub Actions ready (tests coming) | Done | CI/CD foundation |
34+
| First release v1.0.1 published | Done | With .exe and source |
35+
36+
## Current Repository Status (Perfect for Contributors)
37+
- Default branch: `main` (always stable, protected)
38+
- Development branch: `dev` (all PRs go here)
39+
- All contributors: create branch from `dev` → PR to `dev`
40+
- Releases: only from `dev``main` via PR
41+
42+
## What's Coming Next (Top Priority)
43+
1. Dual mode: `--terminal` + `--gui` support (CLI automation)
44+
2. Real token counter (tiktoken + multi-model)
45+
3. Preset profiles (Safe / Aggressive / Nuclear)
46+
4. VS Code extension
47+
5. Portable .exe (single file)
48+
6. GitHub Actions with automatic tests
49+
50+
## Special Thanks
51+
- @Syogo-Suganoya – First contributor, added beautiful dark/light theme toggle
52+
- You – Every star, issue, and suggestion helps!
53+
54+
## Want to Help?
55+
1. Star the repo (it means the world!)
56+
2. Try the app → report bugs → suggest features
57+
3. Pick any "good first issue" from the roadmap
58+
4. Spread the word – we’re going to Product Hunt soon!
59+
60+
Made with passion, frustration with token limits, and love for AI developers.
61+
62+
— totalbrain (creator)
63+
November 2025
64+
65+
AI Token Crusher – Because nobody should pay for whitespace.
66+
67+
168
# AI Token Crusher
269

370
**Cut up to 75% of tokens for Grok • GPT • Claude • Llama • Gemini**
@@ -20,4 +87,4 @@
2087

2188
**Free forever • MIT License • Made for AI developers**
2289

23-
⭐ Star if you saved tokens today!
90+
⭐ Star if you saved tokens today!

REFACTOR_COMPLETE.txt

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
رفاکتور با موفقیت انجام شد!
2+
3+
حالا می‌تونی:
4+
- python -m ai_token_crusher → GUI
5+
- python -m ai_token_crusher -t → CLI
6+
- pip install . → نصب به عنوان پکیج
7+
8+
بقیه تکنیک‌ها رو از کد قدیمی کپی کن تو core/techniques/
9+
GUI رو از کد قبلی منتقل کن به interfaces/gui/
10+
11+
همه چیز آماده لانچ Product Hunt است!

docs/Workflow.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
## Workflow
2+
3+
- **main** → always stable & protected
4+
- **dev** → active development (PRs go here)
5+
- Contributors: create feature branch from **dev** → PR to **dev**
6+
- Release: PR from **dev****main**
7+
8+
Never push directly to main!
9+
10+
- Fork the repo
11+
- Create feature/issue-# branch from dev
12+
- Work on the issue
13+
- PR to dev
14+
- After tests/approve, merge to dev
15+
16+
- For release: PR dev to main
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.

pyproject.toml

Lines changed: 17 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,18 @@
11
[build-system]
2-
requires = ["setuptools>=61.0"]
3-
build-backend = "setuptools.build_meta"
2+
requires = ["setuptools>=45"]
3+
build-backend = "setuptools.build_meta"
4+
5+
[project]
6+
name = "ai-token-crusher"
7+
version = "1.2.0"
8+
description = "Offline AI Token Crusher - Cut up to 75% tokens safely"
9+
authors = [{name = "totalbrain"}]
10+
license = {text = "MIT"}
11+
requires-python = ">=3.8"
12+
13+
dependencies = [
14+
"tkinterdnd2==0.3.0; platform_system=='Windows'",
15+
]
16+
17+
[project.scripts]
18+
token-crusher = "ai_token_crusher.__main__:main"
-189 Bytes
Binary file not shown.

0 commit comments

Comments
 (0)