README.md

Athena AI

An intelligent agent built with the virtuals-sdk framework, designed to provide advanced AI capabilities through a clean and efficient interface.

Project Setup

This project uses Poetry for dependency management and environment isolation. Here's how to get started:

Prerequisites

• Python 3.8 or higher
• Poetry (package manager)

Installation

1. Install Poetry if you haven't already:

   curl -sSL https://install.python-poetry.org | python3 -

2. Install project dependencies:

   poetry install

3. Activate the virtual environment:

   poetry shell

Development Commands

# Format code
poetry run black .
poetry run isort .

# Type checking
poetry run mypy .

# Run tests with coverage
poetry run pytest

# Run linting
poetry run pylint src/athena tests

Project Structure

athena-ai/
├── src/
│   └── athena/
│       ├── __init__.py
│       ├── agent.py       # Core agent implementation
│       └── utils.py       # Utility functions
├── tests/
│   └── test_agent.py
├── pyproject.toml
└── README.md