Getting Started

Avi is an AI agent that works inside projects you organize around whatever you're doing — a company, a side project, a research area. You chat with it, and it can run tools to read and change real things: files, notes, GitHub issues, and more. It can also spin up background agents that keep working on a schedule after the chat ends.

Head to avi.run and sign in with Google. Signing up creates your personal account, a personal organization, and a private Personal project you can use right away. You start with a small pool of free credits — no card required — and connecting your first integration (Google) adds $50 in free credits on top; see Billing & Plans.

2. Connect Google — Avi sets itself up

The first time you open your Personal project, Avi offers to connect your Google account. You choose exactly what to share — Email, Calendar, Drive, Contacts, each with its own toggle — and the moment the connection completes, your default apps configure themselves: Email shows your Gmail, Calendar syncs your calendars, Drive brings in your files. No per-app setup. Connecting also adds the $50 in free credits mentioned above.

Your data stays yours: Avi never trains AI models on it, it's processed only to do what you ask, and it isn't visible to our team unless you explicitly approve access. You can disconnect anytime in Settings → Integrations, and you can skip the whole step and come back to it later from the same place.

3. Open your first project

After sign-in you land in the web app at app.avi.run. Your Personal project is already created. Type a message in the chat to start working with the agent. Simple ways to get oriented:

"What can you do?"
"Take notes on the following plan: ..."
"Email me the weather every morning."

4. Invite teammates (optional)

If you want other people in the same workspace, create a new org and invite teammates. Each member gets private user-owned projects inside the org. See Organizations & Projects.

5. Optional: add Avi to your phone's home screen

On your phone, open app.avi.run and add it to your home screen (on iPhone: Share → Add to Home Screen; on Android: browser menu → Add to Home screen / Install). You get the Avi icon on your home screen, and it opens full screen like a native app.

Key ideas

Org — a workspace you own or belong to. Your personal org is created automatically.
Project — where all of Avi's work lives: chat history, tasks, notes, files, instructions.
Agent — the AI inside a project. One per org, customizable per project.
Tool — something the agent can do for you (send an email, search the web, read a file). You control which tools are on in each project.
Task — a to-do item you and the agent track inside a project.
Background agent — an automation the agent sets up for you: it runs work on a schedule (or once, later) and reports its progress as it goes.
Skill — reusable instructions the agent can load when it needs them.
App — a bundle of related tools (e.g. the GitHub app, the CRM app). Turn apps on per project.