👻 Ghost Toru

Personal terminal AI — powered by your FreeLLMAPI gateway. Stdlib only — no heavy dependencies.

Install (public)

pipx install ghost-toru

Upgrade:

pipx upgrade ghost-toru

Or with pip:

pip install ghost-toru

For run use this command: ghost-toru

Setup (first run)

1. FreeLLMAPI dashboard kholo → Keys page → top header me unified API key → Copy.
2. Fir terminal me:

ghost-toru init

Ye tumse key lega aur ~/.config/ghost-toru/.env me save kar dega.

Manual setup:

export GHOST_TORU_API_KEY="your-unified-key-from-dashboard"
export GHOST_TORU_BASE_URL="http://localhost:3001/v1"  # optional
export GHOST_TORU_MODEL="auto"  # optional: auto / auto:smart / auto:fast

Use

ghost-toru                  # full menu (chat / model / language)
ghost-toru ask "hello"      # one-shot question (streaming)
ghost-toru ask "explain" --no-stream --model auto:fast
ghost-toru chat             # direct chat loop
ghost-toru models           # live model list
ghost-toru init             # first-time setup wizard
ghost-toru key-generate     # local Toru ID banao (isi laptop ke liye)
ghost-toru key-set          # apni key save karo
ghost-toru --help

Chat ke andar:

Config files (auto-created on first run):

• ~/.config/ghost-toru/.env — key, model, lang

System prompt locked hai — koi edit file nahi hai.

Dev (source se)

git clone https://github.com/technicalsuraj2/ghost-toru
cd ghost-toru
python3 -m pip install -e .
ghost-toru

License

MIT