# {{ project_name }}

An EvenAge agent project.

## Getting Started

1) Initialize (already done)

2) Run the environment

```bash
evenage run dev
```

This will start:
- PostgreSQL (with pgvector)
- Redis
- API server (from evenage library)
- Agent workers
- Dashboard

### Access services

- Dashboard: http://localhost:5173
- API: http://localhost:8000

### Add more

- `evenage add agent <name>` - Add a new agent
- `evenage add tool <name>` - Add a custom tool
- `evenage logs <agent>` - View agent logs
- `evenage scale <agent> <N>` - Scale agent to N replicas
- `evenage stop` - Stop all services

## Project Structure

```
{{ project_name }}/
├── evenage.yml          # Project configuration
├── docker-compose.yml   # Infrastructure services
├── .env                 # Environment variables
├── agents/              # Agent implementations (YOUR CODE)
│   └── <agent_name>/
│       ├── agent.yml    # Agent configuration
│       ├── handler.py   # Agent logic
│       └── tools/       # Agent tools
├── workers/             # Worker entry points (YOUR CODE)
│   └── <agent>_worker.py
└── pipelines/           # Pipeline definitions (YOUR CODE)
    └── *.yml
```

## Configuration

Edit `.env` to set API keys:
- `GEMINI_API_KEY` - For Gemini LLM
- `OPENAI_API_KEY` - For OpenAI GPT models
- `SERPER_API_KEY` - For web search tool

## Learn More

- [EvenAge Documentation](https://docs.evenage.dev)
- [Examples](https://github.com/evenage/evenage/tree/main/examples)
