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.

1. Sign up

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.

2. 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."

3. 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.

4. 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 HubSpot app). Turn apps on per project.

Ready to go deeper? Start with Organizations & Projects.