Agora

# Agora **BYOK LLM client with multi-provider access, agentic workflows, and remote device control.** [](LICENSE) [](https://developer.android.com) [](https://kotlinlang.org/)
**English** | [中文](README_CN.md)

Download

Agora is an open-source Android client for using your own model accounts and endpoints. It stores conversations locally, sends model requests directly to the selected provider, supports non-linear message branches and Context Compact, and can extend agent runs with MCP, automation, search, memory, local models, and remote shell tools.

Screenshots

Features

• Nine built-in provider types: OpenAI, Anthropic, Google Gemini, DeepSeek, Qwen/DashScope, OpenRouter, Groq, Ollama, and Local llama.cpp; custom endpoints support OpenAI-compatible, Google, or Anthropic protocols.
• Tree-structured conversations: edit or regenerate earlier messages without discarding alternative branches.
• Token-budget context: 4K–1M estimated-token budgets and non-destructive Compact capsules that retain a verbatim recent suffix.
• Agentic tools: web search, memory, past-conversation RAG, image generation, MCP servers, Tasks/Loops, remote shell/files, durable Conch jobs, and an F-Droid Alpine sandbox.
• Local intelligence: GGUF chat models and local embeddings through llama.cpp.
• Portable data: versioned .agora ZIP archives, ChatGPT/Claude imports, and scheduled backups.
• Customizable UI: Material 3 themes, fonts, haptics, thinking/tool presentation, and 12 explicit interface languages plus system default.

Conch application-layer encryption is enabled when an API key is configured. A blank-key Conch endpoint sends plain JSON and should use HTTPS. External providers and tools receive only the data needed for the feature you invoke; see the privacy documentation for the full boundary.

Documentation

• 📖 User Manual — 28 maintained manual pages covering setup, providers, Context Compact, MCP, automation, tools, privacy, and data management.
• 🏗️ Architecture Guide — current runtime, persistence, providers, tools, and data flows.
• 🧰 Development documentation — internal requirements, baselines, and documentation-maintenance policy.

Public manuals live under docs/<locale>/. Internal engineering documents live separately under development-docs/.

Getting Started

1. Install Agora and open Settings from the conversation drawer.
2. Add credentials under Providers.
3. Sync and enable models under Models.
4. Select a model from the chat bottom bar and send a message.

See the Getting Started manual.

Build from source

The current project targets Android SDK 36 and uses JDK 21 in its repository workflow. Install Android Studio plus the required SDK/NDK components, then use the root project scripts and instructions.

Tech stack

Kotlin, Jetpack Compose Material 3, Coroutines/Flow, Room, DataStore, OkHttp/SSE, kotlinx.serialization, Android NDK/CMake, llama.cpp, Coil, and Markdown/LaTeX rendering.

Privacy

Agora does not relay chat completions or run general analytics. Conversations remain in app-managed local storage, while configured providers and tools are contacted directly when used. Optional update checks and explicitly submitted ratings have documented network destinations. After a crash, one report is kept locally and is sent only if the user confirms on the next launch; it contains diagnostics but no conversation text or credentials. Secret settings normally use an Android Keystore AES-GCM envelope, but legacy values and a deliberate encryption-failure fallback can remain plaintext in DataStore; exported secrets are also unencrypted inside a selected .agora archive.

Read Privacy & Security and the repository Privacy Policy.

Contributing and license

Contributions are welcome through issues and pull requests. Agora is released under the MIT License.