Guide

Getting started

Letronna is an AI agent that stays open beside your work: a window, and the same agent in a terminal. It reads and writes files, runs commands (asking first), keeps notes about you on your disk, and talks to whichever models you choose.

1. Make an account

Sign up on letronna.ai. While Letronna is in alpha, downloads come with an account; it also carries your credit for hosted models, your plan and your teams.

2. Install it

Open Download in the dashboard. It offers your own system first:

• macOS (13 or later, Apple silicon): open the .dmg and drag Letronna into Applications.
• Windows (11, x64): download the .zip, unpack it and run letronna.exe setup — or copy the one-line command and paste it into PowerShell, which does both.
• Linux (x64, glibc 2.31 or later): download the .tar.gz, unpack it and run ./letronna setup — or paste the one-line command into a terminal.

The one-line command carries a download link that works for a few minutes; copy it again after that. Nothing needs administrator rights, and nothing goes outside your own account on the computer.

3. Set it up

letronna setup asks what to call you, signs you in, picks a gateway and a model, and puts the window, the terminal or both where you choose. Run it again any time to change the answers. On Windows and Linux the app then shows up in the start menu or application menu.

4. Sign it in

Signing in happens on letronna.ai: the app opens it for you, or run /login in the terminal. The computer then shows under Devices.

5. Ask it something

Type a message. Letronna answers with the model you picked, and asks before it runs a command or changes a file. Hosted models are paid from your credit; to use your own API keys instead, see Gateways.