Metadata-Version: 2.4
Name: faltoobot
Version: 0.1.0
Summary: WhatsApp-first LLM bot
Requires-Python: >=3.13
Description-Content-Type: text/markdown
Requires-Dist: neonize>=0.3.15.post0
Requires-Dist: openai>=2.28.0
Requires-Dist: pillow>=11.3.0
Requires-Dist: rich>=14.2.0
Requires-Dist: textual>=8.1.1

# faltoobot

WhatsApp bot for LLMs.

## Setup

```bash
git clone https://github.com/pratyushmittal/FaltooBot.git
cd FaltooBot
uv sync
uv run faltoobot configure
```

Configure `~/.faltoobot/config.toml` interactively:

```toml
[openai]
api_key = "your_key_here"
model = "gpt-5.2"
thinking = "none"
fast = false
```

You can rerun `uv run faltoobot configure` anytime to update the file.
If `api_key` is left blank, Faltoobot falls back to `OPENAI_API_KEY` from the environment.

## Run

Authenticate once:

```bash
uv run faltoobot auth
```

Start the bot:

```bash
uv run faltoobot run
```

Start a new CLI session:

```bash
uv run faltoobot chat
uv run faltoobot chat --name "Scratchpad"
uv run faltoochat
```

## Use

Send messages like:

```text
Say hello
/help
/reset
```

In CLI chat:

```text
/help
/reset
/exit
```

`faltoochat` also supports image input. Paste an image file path, paste markdown like `![alt](path)`, or use `Ctrl+V` to attach the current macOS clipboard image.

## Update

```bash
uv run faltoobot update
```

## macOS service

```bash
uv run faltoobot install
uv run faltoobot status
uv run faltoobot logs -f
```

More details: `docs/guide.md`
