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, calendars, scheduled tasks, and more.

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: ..."
  • "Create a task to email me the weather every morning."

3. Make a shared project (optional)

If you want to collaborate, create a new org and invite teammates. Inside the org you can create shared projects — each with its own instructions, tools, and conversation history. See Organizations & Projects.

4. Optional: install the desktop app

The desktop app registers your computer as a device so Avi can run local tools — terminal commands and filesystem operations — on your machine, bridged securely through the cloud. Use it when you want Avi to work with code or files that live on your laptop instead of in the cloud. See Desktop 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 job the agent can run on a schedule or on demand.
  • Skill — reusable instructions the agent can load when it needs them.
  • Module — a bundle of related tools (e.g. the GitHub module, the HubSpot module). Turn modules on per project.

Ready to go deeper? Start with Organizations & Projects.