WhatsApp-first LLM bot
Project description
faltoobot
faltoobot is a personal assistant that lives on its own WhatsApp account.
How it works
- Get a separate SIM / WhatsApp account for Faltoobot.
- Sign in to that account on a spare phone.
- Install
faltooboton a computer that will stay online. - Run
faltoobot authand scan the QR code from that phone. - Message that WhatsApp number from your own number.
Usage
Install
uv tool install faltoobot
Then you can run faltoobot and faltoochat from any folder.
If uv asks you to add its tool bin directory to your PATH, run:
uv tool update-shell
Configure
faltoobot configure
Example ~/.faltoobot/config.toml:
[openai]
api_key = "your_key_here"
model = "gpt-5.4"
thinking = "high"
fast = false
[bot]
allow_groups = false
allowed_chats = ["15551234567@s.whatsapp.net"]
system_prompt = "You are Faltoobot, a concise and helpful AI assistant replying inside WhatsApp. Keep replies practical and readable on mobile."
If api_key is left blank, Faltoobot falls back to OPENAI_API_KEY from the environment.
Set allowed_chats to your own WhatsApp JID or phone number to keep the bot private. Leave it empty only if you want Faltoobot to reply to anyone who can message that account.
Pair and run
Pair the WhatsApp account once:
faltoobot auth
Then start the bot:
faltoobot run
Terminal chat
You can also use Faltoobot locally in the terminal:
faltoobot chat
faltoobot chat --name "Scratchpad"
faltoochat
Commands
On WhatsApp:
/help
/reset
In terminal chat:
/help
/reset
/exit
faltoochat also supports image input. Paste an image file path, paste markdown like , or use Ctrl+V to attach the current macOS clipboard image.
Update
uv tool upgrade faltoobot
Need more details? See docs/guide.md.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file faltoobot-0.2.3.tar.gz.
File metadata
- Download URL: faltoobot-0.2.3.tar.gz
- Upload date:
- Size: 41.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6b82f97b0749153e66a8775e5dab59ff40ed014e5a35a86af905b90763a333ed
|
|
| MD5 |
94be1e93f9ea3f937870ea93d6ad37ed
|
|
| BLAKE2b-256 |
cd2588fb63fbbbc7369c58777efc82cd1ce3dc21c82781721a0d38722ac462ff
|
File details
Details for the file faltoobot-0.2.3-py3-none-any.whl.
File metadata
- Download URL: faltoobot-0.2.3-py3-none-any.whl
- Upload date:
- Size: 31.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5e1a00c9450517cc94ed9695fb652e753715602370312cdd510671561fb809f3
|
|
| MD5 |
94212f63c9b8e178cef0dd3c77e8c9c9
|
|
| BLAKE2b-256 |
084ab56125ee7a97eabf1528daff25b1a0f7a841170ecee6f014df04f08bd949
|
