banteg
57 lines
1009 B
Markdown
57 lines
1009 B
Markdown
# Install & onboard
|
||
|
||
You’ll install Takopi, connect it to Telegram, and generate a working `takopi.toml`.
|
||
|
||
## Prerequisites
|
||
|
||
- A Telegram account
|
||
- Python 3.14+ and `uv`
|
||
- At least one supported engine CLI on your `PATH` (`codex`, `claude`, `opencode`, or `pi`)
|
||
|
||
## 1) Install Takopi
|
||
|
||
```sh
|
||
uv tool install -U takopi
|
||
```
|
||
|
||
## 2) Run onboarding
|
||
|
||
Start Takopi:
|
||
|
||
```sh
|
||
takopi
|
||
```
|
||
|
||
If you want to re-run onboarding later:
|
||
|
||
```sh
|
||
takopi --onboard
|
||
```
|
||
|
||
The wizard walks you through:
|
||
|
||
1. Creating a bot token via [@BotFather](https://t.me/BotFather)
|
||
2. Capturing your `chat_id` (it listens for a message from you)
|
||
3. Choosing a default engine
|
||
|
||
Your configuration lives at `~/.takopi/takopi.toml`.
|
||
|
||
## 3) Verify minimal config
|
||
|
||
After onboarding you should have something like:
|
||
|
||
```toml
|
||
default_engine = "codex"
|
||
transport = "telegram"
|
||
|
||
[transports.telegram]
|
||
bot_token = "123456789:ABCdefGHIjklMNOpqrsTUVwxyz"
|
||
chat_id = 123456789
|
||
```
|
||
|
||
## Next
|
||
|
||
- [First run](first-run.md)
|
||
- [Config reference](../reference/config.md)
|
||
|