> For the complete documentation index, see [llms.txt](https://agentneo.raga.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://agentneo.raga.ai/features/architecture.md).

# Architecture

### System Overview

AgentNeo follows a modular architecture designed for flexibility and extensibility:

<figure><img src="/files/J2WtQ2f4MXSiSnX9Cstw" alt=""><figcaption><p>AgentNeo's System Architecture</p></figcaption></figure>

### Key Components

#### 1. Tracer Module

* Decorators for instrumentation
* Event collection
* Metric computation
* Data buffering

#### 2. Storage Layer

* SQLite database
* JSON log files
* Data persistence
* Query interface

#### 3. Dashboard Service

* Web interface
* Real-time updates
* Data visualization
* Analysis tools

#### 4. Evaluation

* Metric computation
* Performance analysis

### Data Flow

1. **Instrumentation**

   ```python
   @tracer.trace_llm()
   def your_function():
       pass
   ```
2. **Trace Collection**
   * Capture function calls
   * Record timestamps
   * Collect metrics
3. **Data Processing**
   * Compute metrics
   * Generate summaries
   * Update storage
4. **Visualization**
   * Display in dashboard