Getting started
Check CordyAI's download status, then bring a key, pick a provider and model, paste your API key, and start chatting.
CordyAI is bring-your-own-key: instead of signing up for a Cordy account, you connect your own API key from an AI provider. The goal of first run is simple — bring a key, keep control, and be chatting within seconds.
Platform note. These steps describe the current Android implementation in source. At the v0.5.0 source tag, manual checks for camera, share-in, voice, and TalkBack were still open. The repository records no completed iOS binary link, execution, or smoke; image, camera, and voice capture are not wired there. See the FAQ.
Get the build
CordyAI has no public build yet. The public releases repository carries a CordyAI 0.5.0 changelog entry (2026-07-16) that is changelog-only, and its manifest lists CordyAI as unreleased. Builds will be published only through the public releases repository; this page will show the files here when one exists.
CordyAI
No public build yet
No publicly downloadable build yet. The changelog is published here ahead of the first public build.
The first-run steps below describe what the app does once you have a build.
Before you begin
You need one thing: an API key from a supported provider. Cordy does not sell credits or resell model access — you use your own account with the provider, and you pay the provider directly for what you use.
If you don't have a key yet, where to get a key below walks through each provider. If you just want the fastest path, create an OpenRouter key: one key reaches 100+ models.
First run: the onboarding
When you open the app for the first time, a short onboarding explains the model in three cards:
- Local by default — conversations stay on this device unless you erase them.
- Bring your own key — keys are saved with secure device storage (Android Keystore / iOS Keychain).
- Provider requests — prompts are sent only to the provider you select.
Tap Open settings to configure your first provider, or Got it to dismiss the walkthrough. You can reopen it later from Settings → Appearance → Show onboarding again.
Three steps to your first message
1. Open Settings and pick a provider + model
Open Settings from the chat screen and choose Provider & API key. Under Provider, choose where your messages are sent. OpenRouter is selected by default. Open the Model row to pick a model — once you save a key, the list fills with the provider's live catalog and per-model pricing (shown as "In $… / Out $… per 1M"). Before a key is saved, Cordy shows a small built-in list and the status "Add an API key to load this provider's model list".
2. Paste your API key
In the API key group for that provider, paste your key and tap Save key. The field label changes to the provider's name followed by "key saved" (for example "OpenRouter key saved"), and Cordy immediately loads that provider's model catalog. Keys are written to secure device storage only — never to the conversation database or logs.
3. Start chatting
Return to the chat screen. The composer shows "Message CordyAI". A new conversation is a blank canvas; on a fresh install with no key, the canvas instead shows a "Connect a provider to chat" card ("Stored on this device.") with an Add key button that opens Settings. Send your first message and the reply streams in live, rendered as Markdown as it arrives.
That's it — Cordy itself asks for no email, verification, or account. The selected provider may require its own account and billing.
Where to get a key (per provider)
You always create the key in the provider's own console, then paste it into Cordy. Most providers require you to add billing or credits before a key can make requests.
OpenRouter (default, recommended for a first key)
- Go to openrouter.ai/keys and sign in.
- Create a new API key and copy it.
- Add credits to your OpenRouter account (Settings → Credits) so requests can succeed.
- In Cordy: Settings → Provider & API key → OpenRouter → paste key → Save key.
One OpenRouter key reaches models from many vendors (Anthropic, OpenAI, Google, Meta, and more), and its catalog includes live pricing, so Cordy can show what each model costs.
OpenAI
- Go to platform.openai.com/api-keys.
- Create a new secret key and copy it (you won't be able to view it again).
- Make sure your OpenAI account has billing set up.
- In Cordy: Settings → Provider & API key → OpenAI → paste key → Save key.
Anthropic
- Go to console.anthropic.com and open API keys.
- Create a key and copy it.
- Ensure your Anthropic account has credit/billing.
- In Cordy: Settings → Provider & API key → Anthropic → paste key → Save key.
Anthropic runs on Cordy's native Anthropic integration, which supports extended thinking (see Generation controls).
Vercel AI Gateway
- Open your Vercel dashboard and go to AI Gateway.
- Create an API key for the gateway and copy it.
- In Cordy: Settings → Provider & API key → Vercel AI Gateway → paste key → Save key.
Volcengine Ark (火山方舟)
- Open the Ark console.
- Create an API key and copy it.
- In Cordy: Settings → Provider & API key → Volcengine Ark → paste key → Save key.
Your own endpoint
Running a self-hosted or in-house OpenAI-compatible server? You can add it as a custom provider instead of using a built-in.
Confirming it works
- After Save key, the model list should populate with real models and prices. If it stays on the bootstrap entries, your key may be missing or rejected.
- Send a short message. A streaming reply confirms end-to-end success.
- Open Settings → Token usage to see the tokens and estimated cost recorded for that message.
If something goes wrong
- "Check your API key" — the key is missing, empty, or rejected (HTTP 401/403). Re-paste it in Settings.
- "Provider credits exhausted" — add credits/billing with the provider (HTTP 402).
- "Provider is rate limited" — wait a moment and retry (HTTP 429).
The FAQ & troubleshooting page has the full recovery guide.