Skip to content

Getting Started

This guide walks you through installing Agora, adding your first API key, and sending your first message.

Installation

Agora is available on F-Droid, the open-source Android app store.

  1. Install F-Droid on your device
  2. Open F-Droid, search for Agora
  3. Tap Install

From GitHub Releases

  1. Visit the Releases page
  2. Download the latest .apk file
  3. Open the file on your device and confirm installation when prompted

Build from Source

If you prefer building yourself:

  1. Clone the repository: 
    git clone https://github.com/newo-ether/Agora.git
  2. Open the project in Android Studio (Ladybug or newer)
  3. Sync Gradle and build

Requirements: Android SDK 34+, JDK 17+.

First Launch

When you open Agora for the first time, you'll see a welcome screen with a text input. Before you can chat, you need to configure a provider and an API key.

Step 1: Add an API Key

  1. Tap the Settings icon (bottom-right gear) in the navigation bar
  2. Under Services, tap Provider
  3. Select a provider from the list (e.g., OpenAI, Anthropic, Google)
  4. Tap Add New Key
  5. Enter a name for your key (e.g., "Personal") and paste your API key
  6. Tap Add
Where do I get an API key?

See the API Providers page for details on each provider.

Step 2: Sync Models

  1. Go back to Settings and tap Models (under Services)
  2. Tap Sync from All Providers
  3. Agora fetches the latest model list for all configured providers
  4. Once synced, tap a model to set it as your Default Model

Step 3: Send Your First Message

  1. Tap the back arrow to return to the chat screen
  2. Type a message in the input field at the bottom
  3. Tap Send (paper plane icon)

The model will stream its response in real time.

App Layout

Agora has a clean layout centered around the chat screen:

Top Bar

  • Conversation title — displays the current conversation name (tap to rename)
  • Hamburger menu (:material-menu:) — opens the conversations drawer
  • Overflow menu (:material-dots-vertical:) — per-conversation settings (model, system prompt, generation params)

Conversations Drawer

Tap the hamburger menu or swipe right from the left edge to open:

  • Search bar — find past conversations by keyword or semantic search
  • Conversation list — all conversations, newest first
  • Settings (:material-cog:) — configure providers, models, prompts, and more
  • New Chat — start a fresh conversation

Chat Screen

  • Message area — scrollable conversation history with markdown rendering
  • Bottom bar — text input, model selector, attachment button (+), and send button

Next Steps