Metadata-Version: 2.4
Name: ghost-toru
Version: 1.0.1
Summary: Ghost Toru — personal terminal AI powered by FreeLLMAPI gateway
Author: technicalsuraj2
License: MIT
Project-URL: Homepage, https://github.com/technicalsuraj2/ghost-toru
Project-URL: Repository, https://github.com/technicalsuraj2/ghost-toru
Project-URL: Issues, https://github.com/technicalsuraj2/ghost-toru/issues
Keywords: ai,terminal,cli,llm,chatbot
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# 👻 Ghost Toru

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

## Install (public)

```bash
pipx install ghost-toru
```

Upgrade:

```bash
pipx upgrade ghost-toru
```

Or with pip:

```bash
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:

```bash
ghost-toru init
```

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

Manual setup:

```bash
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

```bash
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:

| command | kaam |
|---|---|
| `/models`, `/list` | live models dikhao |
| `/use <number\|name>` | model switch |
| `/lang <name>` | language switch (Hinglish, Hindi, English…) |
| `/bye` | exit |

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)

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

## License

MIT
