> ## 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.
# OCR
> Extract text from images
Agents can read text from images - receipts, documents, signs, and screenshots.
```mermaid theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
graph LR
subgraph "Text Extraction"
A[👤 User] --> B[🤖 Agent]
B --> C[🖼️ Image]
C --> D[📝 Text]
end
classDef agent fill:#8B0000,color:#fff
classDef tool fill:#189AB4,color:#fff
class B agent
class A,C,D tool
```
## Quick Start
```typescript theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
import { Agent } from 'praisonai';
const agent = new Agent({
instructions: 'Extract all text from images',
llm: 'gpt-4o' // Vision-capable model
});
await agent.chat([
{ role: 'user', content: [
{ type: 'text', text: 'What text is on this receipt?' },
{ type: 'image', url: 'https://example.com/receipt.jpg' }
]}
]);
// "Store: Coffee Shop, Total: $4.50..."
```
```typescript theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
const agent = new Agent({
instructions: 'Extract data as JSON',
outputFormat: 'json'
});
await agent.chat([
{ role: 'user', content: [
{ type: 'text', text: 'Extract items and prices from this receipt' },
{ type: 'image', path: './receipt.jpg' }
]}
]);
// { items: [...], total: 4.50, date: '...' }
```
***
## User Interaction Flow
```mermaid theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
sequenceDiagram
participant User
participant Agent
participant Vision
User->>Agent: "Read this receipt"
User->>Agent: [image attachment]
Agent->>Vision: Analyze image
Vision-->>Agent: Detected text
Agent-->>User: "Items: Coffee $3.50..."
```
***
## Configuration Levels
```typescript theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
// Level 1: Bool - Enable with vision model
const agent = new Agent({
llm: 'gpt-4o',
vision: true
});
// Level 2: String - High detail for small text
const agent = new Agent({
llm: 'gpt-4o',
vision: 'high'
});
// Level 3: Dict - Full options
const agent = new Agent({
vision: {
detail: 'high',
ocr: true,
language: 'en'
}
});
```
***
## Common Uses
| Use Case | Example |
| -------------- | ---------------------------- |
| Receipts | Extract items, totals, dates |
| Business cards | Get contact information |
| Documents | Digitize scanned papers |
| Screenshots | Read displayed text |
***
## API Reference
Complete configuration options
Full class documentation
***
## Best Practices
Set `detail: 'high'` when reading receipts or documents.
"Extract the total and date" works better than "read this".
Clear, well-lit images produce better results.
***
## Related
Image analysis
File operations