Skip to content

# Agora User Manual

Welcome to the Agora user manual. Agora is a BYOK (Bring Your Own Key) LLM client for Android with multi-provider access, non-linear branching conversations, agentic tool calling, and remote device control.

## Quick Links

### Getting Started

- Getting Started — install, configure, and send your first message
- FAQ — answers to common questions

### Core Features

- Conversations — non-linear branching, message operations, streaming, markdown rendering
- API Providers — connect to OpenAI, Anthropic, Google, DeepSeek, Ollama, and custom endpoints
- Models — enable/disable models, aliases, per-provider model sync
- System Prompts — three-section editor, variable substitution, per-conversation switching
- Generation — temperature, top P, max tokens, thinking, frequency/presence penalties
- Title Generation — auto-generate conversation titles
- Image Transcription — image-to-text pipeline for vision-blind providers
- Appearance — theme mode, color scheme, dynamic color, scheme style

### Agentic Tools

- Overview — how multi-round tool calling works
- Web Search — Brave, Serper, Tavily, SearXNG integration
- Remote Shell (Conch) — encrypted remote command execution, file operations, MCP integration
- Sandbox — local Alpine Linux environment for isolated command execution

### Knowledge Management

- Conversation Search — keyword and semantic (RAG) search over chat history
- Embedding / RAG — configure embedding models for semantic retrieval
- Memory & Cache — active memory, saved memories, auto-caching

### More

- Local Models — run GGUF models on-device via llama.cpp
- PDF Import — extract and send PDF pages to vision models
- Data Portability — export/import .agora files, import from Claude and ChatGPT
- Language — switch between English, Chinese, or system default
- About — version info, updates, documentation toggles, links, rating

## About Agora

Agora is a BYOK Android client for AI power users:

- No middlemen: Direct API connections, no telemetry, no tracking
- On-device storage: Everything lives locally in a Room database
- Non-linear conversations: Edit any past message and explore alternative branches
- Agentic by default: Multi-round tool calling with web search, shell execution, file operations, and memory
- Remote control: Manage servers via the encrypted Conch protocol
- Open source: MIT licensed, source on GitHub