# Installation

## Requirements

- Python 3.10+
- pip (or [uv](https://docs.astral.sh/uv/) for development)

## Install from PyPI

```bash
pip install cryptobot-python
```

Install optional extras only when needed:

```bash
pip install "cryptobot-python[webhook]"
pip install "cryptobot-python[docs]"
```

## Verify Installation

```python
from cryptobot import CryptoBotClient
print(CryptoBotClient)
```

## Install from Source

```bash
git clone https://github.com/ragnarok22/cryptobot_python.git
cd cryptobot_python
uv sync
```

For documentation tooling:

```bash
uv sync --extra docs
```

For local webhook development with FastAPI/Uvicorn:

```bash
uv sync --extra webhook
```

## Development Setup

```bash
uv sync
make lint
make test
```

## Common Pitfalls

- Use `cryptobot-python` as the package name in `pip install`.
- Keep mainnet and testnet tokens separate.
- Store tokens in environment variables instead of source code.