# Installation

## Requirements

- Python 3.8 or higher
- pip or Poetry package manager

## Standard Installation

### Using pip

```bash
pip install trc20-monitor
```

### Using Poetry

```bash
poetry add trc20-monitor
```

## Installation with Optional Dependencies

### SQLAlchemy Support

For advanced database backends (PostgreSQL, MySQL):

```bash
pip install trc20-monitor[sqlalchemy]
```

### Full Feature Set

Install with all optional dependencies:

```bash
pip install trc20-monitor[full]
```

## Development Installation

### Clone the Repository

```bash
git clone https://github.com/kun-g/trc20-monitor.git
cd trc20-monitor
```

### Install in Development Mode

Using pip:

```bash
pip install -e ".[dev]"
```

Using Poetry:

```bash
poetry install --with dev
```

### Run Tests

```bash
pytest
```

### Code Quality Checks

```bash
# Format code
black trc20_monitor tests

# Sort imports
isort trc20_monitor tests

# Type checking
mypy trc20_monitor

# Linting
flake8 trc20_monitor tests
```

## Docker Installation

### Using Pre-built Image

```dockerfile
FROM python:3.11-slim

RUN pip install trc20-monitor

COPY your_script.py /app/
WORKDIR /app

CMD ["python", "your_script.py"]
```

### Building from Source

```dockerfile
FROM python:3.11-slim

WORKDIR /app

COPY . .
RUN pip install .

CMD ["trc20-monitor", "--help"]
```

## Verifying Installation

After installation, verify everything is working:

```python
import trc20_monitor
print(trc20_monitor.__version__)
```

Or use the CLI:

```bash
trc20-monitor --version
```

## Troubleshooting

### Import Errors

If you encounter import errors, ensure all dependencies are installed:

```bash
pip install --upgrade trc20-monitor
```

### SSL Certificate Issues

On some systems, you might need to install certificates:

```bash
pip install --upgrade certifi
```

### Permission Errors

On Linux/macOS, you might need to use sudo or a virtual environment:

```bash
# Using virtual environment (recommended)
python -m venv venv
source venv/bin/activate  # On Windows: venv\\Scripts\\activate
pip install trc20-monitor

# Or using user installation
pip install --user trc20-monitor
```

## Uninstallation

To remove the package:

```bash
pip uninstall trc20-monitor
```