# Architecture

### System Overview

AgentNeo follows a modular architecture designed for flexibility and extensibility:

<figure><img src="https://596559954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoCH4wJjrvrQMmLCveYi3%2Fuploads%2FsLa0LwBQX2dll85JkqFc%2Farchitecture.svg?alt=media&#x26;token=534cb14c-fa41-43d4-af84-faaf1aaa220c" 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