Quickstart

In just a few minutes you'll install Imaginne, log in, and complete your first task.

Prerequisite: an organization account

Imaginne uses your organization's login. If you don't have access yet, ask an administrator to create your user in the console — you'll receive an email to set your password. There's no standalone sign-up and no API key to configure.

1. Pick your surface

Desktop

The native app for macOS and Windows.

1. Open the console at https://ai.nnumbers.com.br/app and click Download Desktop (top right), or ask your administrator for the installer.
2. Install:
   • macOS — open the .dmg and drag Imaginne into Applications.
   • Windows — run the installer and choose the folder.
3. Open Imaginne. On the welcome screen, click Sign in. The browser opens, you sign in with your organization email, and you return to the app already authenticated.
4. Click + to create a project (a working folder). The app starts a session automatically.

➡️ Details in Install Desktop and Use the Desktop.

Terminal (TUI)

The full agent inside your terminal.

1. Install with the official installer (it doesn't use sudo; it installs to ~/.imaginne/bin):

   curl -fsSL https://ai.nnumbers.com.br/downloads/install.sh | bash

   Reopen your terminal (or reload your PATH) so the imaginne command becomes available.
2. Start Imaginne:

   imaginne

   On first run, it opens the login in your browser automatically. Complete the login and return to the terminal.
3. You'll see the chat screen. Type a message and press Enter.

➡️ Details in Install TUI and Use the TUI.

VS Code

The extension that brings the agent into your editor.

1. Install the Imaginne binary (the extension uses the local CLI):

   curl -fsSL https://ai.nnumbers.com.br/downloads/install.sh | bash

2. In VS Code, open the Extensions tab and search for Imaginne (nnumbers.imaginne). Install it.
3. Open a project folder (the extension needs a workspace open).
4. Open the chat with Ctrl/Cmd+Shift+I and run /login in the message field to authenticate.

➡️ Details in Install VS Code and Use it in VS Code.

Browser

Nothing to install.

1. Go to https://ai.nnumbers.com.br/chat.
2. Sign in with your organization account.
3. Click ＋ New chat and start the conversation.

➡️ Details in Chat in the browser.

2. Run your first task

With the session open, ask for something concrete. Good first requests:

• "Create a 5-slide presentation about the launch of our product X."
• "Read the file data.csv and give me a summary with the top 3 highlights."
• "Generate a Word document with the minutes of this meeting from my notes."
• "Create an image for the campaign banner from this description."

The agent will plan, execute, and — when it generates a file — show it as an artifact for you to open or download.

Mention files

On the Desktop and in the terminal, type @ followed by the path to point to a file in your project (e.g., @data.csv). See Files & artifacts.

3. Adjust autonomy (optional)

By default, the agent confirms sensitive operations before running them (medium autonomy). You can have it ask at every step (low) or act without confirming (high) in trusted workspaces. See Autonomy.

Next steps

📘Learn your surface in depth

Advanced features: voice, routines, remote sessions, artifacts, and more.

Open →🧠Understand the concepts

How Imaginne works under the hood, in plain language.

Open →🧰Discover the skills

What the agent can do and how to extend it with new skills.

Open →