Skip to main content

Simple CLI tool for AI text rewriting with Ollama

Project description

🔥 Redukon

Reduce Your Tokens. Keep Your Intent.

PyPI Python License Stars


✨ What is Redukon?

Redukon is a token-saving prompt rewriter that uses local small AI models to optimize your prompts — reducing token count while keeping the core intent intact.

No API keys needed. Runs entirely offline with Ollama.

💡 Perfect for:

  • Saving money on API calls
  • Fitting more context into LLM windows
  • Making prompts more efficient

🚀 Quick Start

# Install from PyPI
pip install redukon

# Or install latest from GitHub
pip install -e https://github.com/CharlesArea/Redukon.git

# One-time setup (installs Ollama + picks a model)
redukon onboard

# Rewrite prompts to save tokens!
redukon rewrite -i "Your long prompt here..."

📖 Usage

redukon onboard

Interactive setup wizard:

  1. Checks if Ollama is installed
  2. Installs Ollama if needed
  3. Choose your model:
    Model Size Best For
    qwen2.5:0.5b 397MB Speed & minimal resources
    llama3.2:1b 1.9GB Balanced
    phi3:3.8b 2.3GB Better quality

redukon rewrite

Rewrite your prompts!

# Basic
redukon rewrite -i "Please write a comprehensive Python function..."

# From file
redukon rewrite -i @long-prompt.txt -o optimized.txt

# Custom temperature (lower = more focused)
redukon rewrite -i "prompt" --temp 0.3

⚡ Example

Before (87 tokens) After (42 tokens)
"Please write a comprehensive Python function that takes a list of integers as input and returns a new list containing only the even numbers from the original list. The function should handle edge cases like empty lists, lists with no even numbers, and lists with negative numbers. Please include proper type hints, docstrings, and error handling." "Write a Python function that filters even numbers from a list. Include type hints, error handling, and docstrings."

📉 Savings: ~52%


🔧 Options

Flag Description Default
-i, --input Prompt or @file.txt Required
-o, --output Output file Print to stdout
-m, --model Override model From config
-t, --temp Temperature (0.0-1.0) 0.3

🛠️ Requirements

  • Python 3.8+
  • Ollama (installed automatically during onboard)

📝 License

MIT © 2026 CharlesArea


Made with ❤️ for the AI community

GitHubPyPIReport Bug

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

redukon-3.1.0-py3-none-any.whl (9.3 kB view details)

Uploaded Python 3

File details

Details for the file redukon-3.1.0-py3-none-any.whl.

File metadata

  • Download URL: redukon-3.1.0-py3-none-any.whl
  • Upload date:
  • Size: 9.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for redukon-3.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3e98a5f5d5e9346734f470e06654a22458ad75f350f5bc0e40012d97b27e7a8d
MD5 8bc63977104c65308f9ec9e2f7ed91cd
BLAKE2b-256 812c5c4a0858afb013c0196c637b819fe8e659fa03947abe193f7603bc7f9a45

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page