> ## Documentation Index
> Fetch the complete documentation index at: https://chibi.bot/llms.txt
> Use this file to discover all available pages before exploring further.

# Manual Installation

> Run Chibi directly from source code.

## Prerequisites

* **Python 3.10+**: Ensure Python is installed (`python --version`).
* **Poetry**: Chibi uses Poetry for dependency management. [Install Poetry](https://python-poetry.org/docs/#installation).
* **Git**: To clone the repository.

## Installation Steps

### 1. Clone the Repository

```bash theme={null}
git clone https://github.com/s-nagaev/chibi.git
cd chibi
```

### 2. Install Dependencies

Use Poetry to install the required Python packages.

```bash theme={null}
poetry install
```

### 3. Configure Environment

Copy the example configuration file and edit it.

```bash theme={null}
cp .env.example .env
```

Edit `.env` with your API keys and settings:

```dotenv theme={null}
TELEGRAM_BOT_TOKEN=your_token
OPENAI_API_KEY=sk-...
# ... other keys
```

You can read more about Agent configuration here: [core settings](/configuration/core-settings)
You can get the env file template with all available settings here: [.env template](/configuration/env-template)

### 4. Run the Bot

Start the bot using Poetry:

```bash theme={null}
poetry run python main.py
```

> **Tip:** For a simpler installation, see [Pip Installation](/installation/pip-installation).

## Troubleshooting

* **Poetry not found:** Make sure Poetry is in your PATH.
* **Python version mismatch:** Chibi requires Python 3.10 or newer.