core concept
AI Interpreter
The brain behind Aura OS — understanding natural language and translating it to Web3 actions.
Overview
The AI Interpreter is the core intelligence of Aura OS. It takes your natural language input, understands the intent, and outputs a structured command that the blockchain executor can process.
💬
Natural Language
"Send 0.1 ETH to..."
→
🧠
AI Interpreter
Parse & Validate
→
⛓️
Structured Intent
SEND_TOKEN
Two-Stage Parsing
Aura uses a hybrid approach for maximum speed and accuracy:
⚡
Stage 1: Quick Parse
Instant regex-based matching for common patterns. No API calls needed.
// Matches patterns like:
"gas" → GET_GAS
"price eth" → GET_PRICE(ETH)
"my address" → GET_ADDRESS
"0x..." → GET_TRANSACTIONS
🤖
Stage 2: AI Parse
For complex queries, Aura uses LLMs with structured output (JSON schema).
1. GPT-4o-mini
→ 2. Groq (Llama 3.3)
→ 3. Gemini 1.5 Flash
Automatic fallback chain for reliability
Intent Schema
Every parsed command produces a structured Intent object:
Intent Schema (TypeScript)
interface Intent
action: "CHECK_BALANCE" | "SEND_TOKEN" | ...
token: string | null
amount: number | null
target_address: string | null
chain: string | null
reason: string | null
Supported Actions
CHECK_BALANCE Check token balance in wallet SEND_TOKEN Transfer tokens to address SWAP_TOKEN Exchange one token for another GET_PRICE Get current token price GET_GAS Get current gas price GET_ADDRESS Show wallet address GET_TRANSACTIONS Fetch transaction history REJECTED Non-Web3 request rejected Multilingual Support
The AI Interpreter understands multiple languages:
English
"Check my ETH balance"
→ CHECK_BALANCE
Vietnamese
"Số dư ETH của tôi là bao nhiêu?"
→ CHECK_BALANCE
Rejection Handling
Non-Web3 requests are gracefully rejected with an explanation:
❯ aura chat "How do I cook pasta?"
✗ REJECTED
Aura OS only supports Web3 tasks like checking balances, sending tokens, and tracking prices.