Help Center
Quick reference and troubleshooting for Avori.
Start with the matching tutorial
Avori Tutorials show the full task, what you should see at each step, who pays for model usage, how to prove the result in the real project, and how to undo or recover.
๐ Quick Start Guide
- Download Avori for Windows. macOS is coming soon. Run the installer.
- Launch Avori โ it will appear in your system tray and start in the background.
- Sign in when prompted (Google, GitHub, or email). Your account is created automatically on first sign-in.
- Choose Build inside Avori, Start a new game in an engine, or Connect an existing project. Install any engine separately.
Open the written starting-path guide. It includes the reviewed silent walkthrough captured from the installed Avori experience.
Included integrations: Unity ยท Godot 4 ยท Unreal Engine ยท VS Code ยท Visual Studio 2022 ยท JetBrains Rider. Context and action coverage differ by workflow.
๐ง GDD & Project Indexing
Avori indexes your project in the background. To align Avori with your Game Design Document:
- Open a project, then use the GDD button in Avori's top bar to attach or create its design document.
- PDF, Word (.docx), Markdown, and plain text files are supported.
- Ask Avori: "Is this combat system in line with my GDD? Please explain without changing anything."
- Describe the art in ordinary language. If you name another game, Avori should extract useful design principles while keeping your characters, world, interface, and assets original.
- Review the saved art direction and preserve-or-create choices before approving asset work. See the GDD and art-direction guide.
๐ณ Managing your Account
Everything is managed from your Avori Dashboard or from inside the Hub app itself.
- View Usage: Sign in at avorihq.com/dashboard to see trial requests, provider-key status, Avori balance, deposits, and usage history. The panel's top bar shows the active funding source and only low/empty warnings; exact money stays in the funding details.
- Model Funding: The one-time Trial includes 100 Gemini 2.5 Flash requests. Personal BYOK is free indefinitely, while your provider bills model usage directly. Avori-hosted models use prepaid Avori balance. Pro and Studio software subscriptions do not include model usage. Avori never changes to a paid payer automatically.
- Failed subscription payments: If a renewal fails or your bank requires confirmation, only the affected paid cloud or Studio feature pauses until billing is fixed. Core local features, free Personal BYOK, and existing Avori balance remain available. Open Dashboard - Billing to resolve it.
- New computer: Sign in with the same Avori account to restore your account, saved personal-key configuration, and paid cloud entitlement. Local-only chats, GDDs, rules, and project context do not automatically sync; use Avori Settings - Transfer Avori Data on the old computer, or Pro cloud continuity where enabled.
- Update Billing / Cancel: Go to Dashboard โ Billing. Avori lets you choose plans there, and Stripe handles secure payment details and cancellation confirmation.
Security Authentication
Avori supports three sign-in methods โ use whichever is easiest for you:
- Google OAuth โ One click, no password. Recommended for most users.
- GitHub OAuth โ Sign in with your GitHub account.
- Email + Password โ Create an account with your email address and a password. Go to avorihq.com/auth/email and select "Create Account".
The Hub refreshes a valid session in the background. If the session expires or is revoked, sign in again to reconnect.
๐ ๏ธ Troubleshooting
- Hub not connecting? Make sure Avori is running in your system tray, restart Avori, then reopen your engine or IDE. If it still cannot connect, check Windows Firewall and send a diagnostic report from Avori โ Settings.
- No model response? Check your internet connection, sign-in state, selected model, and the funding source shown in Avori. A failed Pro or Studio renewal pauses only the affected paid cloud/team feature; it does not remove Core, valid Personal BYOK, or an existing Avori Balance.
- Trial or Avori funding unavailable? Trial requests are one-time and do not reset. For a reviewed multi-step build, Avori requires the selected payer to cover the whole worst case before approval. Connect a provider key for provider-billed usage, reduce the reviewed work, or add Avori balance for Avori-hosted models. Core local work remains available without either source.
Automatic problem reports:
When enabled, Avori privately sends a small technical report if Avori itself breaks and gives the incident a reference such as AVORI-12AB34CD56EF. It never sends prompts, chats, project content, GDDs, keys, payment information, balances, or private file paths. You can review the exact fields, turn automatic reports off, or send your own description from Avori โ Settings โ Account โ Support.