> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Context Module

> Fast context retrieval for codebase understanding

# Context Module

The context module provides fast context retrieval capabilities for codebase understanding, including the FastContext class for intelligent code search.

## Installation

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
pip install praisonaiagents
```

## Quick Start

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents import FastContext

# Create fast context instance
context = FastContext(workspace_dir="./my_project")

# Search for relevant code
result = context.search("authentication logic")
print(result.files)
print(result.snippets)
```

## Classes

### FastContext

Fast codebase context retrieval.

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents import FastContext

context = FastContext(
    workspace_dir="./project",
    max_results=10
)
```

#### Methods

| Method              | Description              |
| ------------------- | ------------------------ |
| `search(query)`     | Search for relevant code |
| `get_file(path)`    | Get file contents        |
| `get_symbols(path)` | Get symbols in file      |

### FastContextResult

Result from a context search.

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents import FastContextResult

result = context.search("database connection")
result.files       # Matching files
result.snippets    # Code snippets
result.relevance   # Relevance scores
```

### FileMatch

A matched file from search.

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents import FileMatch

match.path        # File path
match.score       # Relevance score
match.lines       # Matching line ranges
```

### LineRange

A range of lines in a file.

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents import LineRange

range.start    # Start line
range.end      # End line
range.content  # Line content
```

## Usage Examples

### Basic Search

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents import FastContext

context = FastContext(workspace_dir="./src")
result = context.search("user authentication")

for file in result.files:
    print(f"{file.path}: {file.score}")
```

### With Agent

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents import Agent, FastContext

context = FastContext(workspace_dir="./project")

agent = Agent(
    name="CodeAssistant",
    context=context
)

# Agent can search codebase for context
```

## Related

* [Agent](/docs/sdk/praisonaiagents/agent/agent) - Agent configuration
* [Knowledge](/docs/sdk/praisonaiagents/knowledge/knowledge) - Knowledge base