# Development Setup

### Initial Setup

1. Clone the Repository

```bash
git clone https://github.com/raga-ai-hub/agentneo.git
cd agentneo
```

2. Create Virtual Environment

```bash
python -m venv venv
source venv/bin/activate  # Unix
# or
venv\Scripts\activate  # Windows
```

3. Install Development Dependencies

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

### Development Tools

#### Required Tools

* Python 3.8+
* Git
* pytest
* black (code formatting)
* isort (import sorting)
* flake8 (linting)

#### Installing Development Tools

```bash
pip install black isort flake8 pytest pytest-cov
```

### Setting Up Pre-commit Hooks

```bash
pre-commit install
```

### Running Tests

```bash
# Run all tests
pytest

# Run with coverage
pytest --cov=agentneo tests/

# Run specific test file
pytest tests/test_tracer.py
```

### To run the dashboard after local UI code changes 

```bash
# 1. Move to the UI folder
> cd agentneo/ui

# 2. Install the dependencies
> npm i

# 3. Build the UI files after the code changes
> npm run build

# 4. Go back to the root folder
> cd ..

# 5. Remove any previous installations of agentneo
> pip uninstall agentneo

# 6. Install the updated code
> pip install -e .
```