Skip to content
kunjikunji docs

A free AI command-line tool for Windows

kunji is a free, open-source AI app for the Windows terminal. It works in Windows Terminal, Command Prompt and PowerShell, and you can use it without paying anything by picking a provider with a free tier or a model that runs on your own PC.

Install

Section titled “Install”

With Python (3.11 or newer):

Terminal window
python -m pip install kunji

If python isn’t found, try py -m pip install kunji.

Without Python: download kunji-windows-x64.exe from the latest release, rename it to kunji.exe and run it from a terminal in that folder.

Then run:

Terminal window
kunji

A menu opens. Use the arrow keys and Enter; you don’t need to learn any commands.

Free ways to use it

Section titled “Free ways to use it”
Option What you need Notes
Google Gemini A free key from aistudio.google.com/apikey Free tier with daily limits
Groq A free key from console.groq.com/keys Very fast open models, free tier with rate limits
Ollama Ollama for Windows Models run on your PC: no key, no bill, works offline

Free tiers and their limits are set by each provider and can change; check their pages.

Add one from the menu (Providers and keys → Add a provider) or with a command:

Terminal window
kunji keys add gemini
kunji keys add groq
kunji keys add ollama

Your key is saved in Windows Credential Manager, not in a text file.

What you can do

Section titled “What you can do”
Terminal window
kunji chat                                   # chat
kunji ask "how do I find which process uses port 3000?"
kunji ask -f script.ps1 "explain this script"
kunji compare "write a haiku about rain"     # several models side by side
kunji @commit                                # commit message for staged git changes

Make it look right

Section titled “Make it look right”

kunji uses hex colours that look the same in every Windows theme, and it adapts to any window width. For the best result use Windows Terminal (free in the Microsoft Store) with a font like Cascadia Mono, which is the default.

Troubleshooting

Section titled “Troubleshooting”
  • “kunji is not recognized”: run python -m kunji instead, or see Troubleshooting to fix your PATH.
  • Windows SmartScreen warns about the .exe: the file is new and not yet widely downloaded. You can check it against the checksums on the release page, or install with pip.