Skip to content
Kompil 1.5.1 · Changelog

// tutorial

From download to your first team project.

Step by step, with the app's screens. The first time, Kompil itself opens an eight-step guided tour — and you can replay it under Help › Kompil tutorial (Ajuda › Tutorial do Kompil). The app interface is in Portuguese (Brazil).

Download for WindowsSee the guided tour
  1. 01

    Download and install

    On this site's Download page, choose Windows: the installer downloads right away. Open Kompil-Setup.exe; if Windows shows “Windows protected your PC”, click More info → Run anyway. Accept the terms, choose the folder and shortcuts: Kompil opens by itself and future versions arrive through automatic updates.

    • Windows 10 and 11 (64-bit)
    • ~600 MB free
    • Containers: WSL 2 (the Kompil Engine installs the rest)
  2. 02

    Sign in or create your account

    The app asks for an account to get started. Sign in with your email or create a free account: the confirmation code arrives by email. Then four quick welcome questions tailor the app to you.

    Sign in or create your account
    Kompil sign-in screen with the infinity symbol, Sign in with email and Create for free
  3. 03

    Take the guided tour

    The first time, a one-minute tour lights up each important part of the screen with an arrow and an explanation: where to create projects, search, the menus, themes and layout, your account and what's inside a project. You can skip it at any time.

    Take the guided tour
    Kompil guided tour, step 1 of 8
  4. 04

    Create or import a project

    “Everything starts here” (Tudo começa aqui): create a project from a template, import a GitHub repository or a folder from your computer. If the folder has a .git with a remote and GitHub is connected, the repository links itself.

    • Shortcut: Ctrl+Alt+N
    Create or import a project
    Kompil guided tour, step 2 of 8
  5. 05

    Find anything

    Files, projects and commands in one place, in the search box on the title bar.

    • Files and projects: Ctrl+P
    • All commands: Ctrl+Shift+P
    Find anything
    Quick search with the project's open and recent files
  6. 06

    Invite the team and code together

    In the People panel (Pessoas), Invite creates an invitation with each person's role. Whoever joins shows up with their cursor and name in the file they are in, and clicking an avatar takes you to that person's cursor.

    • Illustrative profile photo: a smiling woman
    • Illustrative profile photo: a motorcyclist wearing a helmet
    • Illustrative profile photo: a smiling man with glasses
    • Illustrative profile photo: a dog
    • Illustrative profile photo: a smiling woman in sunglasses
    • Illustrative profile photo: a cat
    • Illustrative profile photo: a man with glasses

    Who is in the file right now · 7

    Invite the team and code together
    Editor with cart.js open, Bia Lima's named cursor and the People panel with two people online
  7. 07

    Comment on a line and chat

    Hover over the gutter and click the “+” to comment on a line; Ctrl+Enter sends it. The project chat sits on the right side.

    Comment on a line and chat
    A comment being written on line 15 of payments.js, visible to the whole project
  8. 08

    Run and debug

    Run (F5) starts the project; the terminal sits at the bottom (Ctrl+`). To pause, click next to the line number or press F9 for a breakpoint.

    Run and debug
    Run and debug panel with breakpoints, running locally and in the cloud
  9. 09

    Turn on Git

    In Source control, publish the project to a new repository or link an existing one. GitHub connects from the photo menu, with a device code.

    Turn on Git
    Source control: publish the project or link it to an existing repository
  10. 10

    Connect your AI

    Under Settings › AI connections (Configurações › Conexões de IA), paste your key: Kompil shows the provider and the text models on your account, you pick the model and name the connection. In the agent, just choose the connection by name. The key stays encrypted on your computer only.

    Connect your AI
    Settings › AI connections: paste an API key, Ollama or a compatible server
  11. 11

    Make it yours

    Change the theme of the whole IDE, show or hide the sidebars and the terminal, and choose the app icon color under Settings › Appearance (Configurações › Aparência).

    Make it yours
    Settings › Appearance: zoom, editor and terminal font and the app icon color

// help › kompil tutorial

The guided tour, step by step

The first time, the screen dims and the important part lights up with an arrow and an explanation. Some steps ask for a click; you can skip at any time.

  1. Kompil guided tour, step 1 of 8

    step 1 of 8

    Welcome to Kompil

  2. Kompil guided tour, step 2 of 8

    step 2 of 8

    Everything starts here

  3. Kompil guided tour, step 3 of 8

    step 3 of 8

    Find anything

  4. Kompil guided tour, step 4 of 8

    step 4 of 8

    The menus you already know

  5. Kompil guided tour, step 5 of 8

    step 5 of 8

    Themes and layout

  6. Kompil guided tour, step 6 of 8

    step 6 of 8

    Your account, GitHub and AIs

  7. Kompil guided tour, step 7 of 8

    step 7 of 8

    Inside a project

  8. Kompil guided tour, step 8 of 8

    step 8 of 8

    Ready to start

// free account

Join the orbit.

Creating an account is free. Download the app for Windows or sign in on the web to edit and chat from anywhere.

  • Your AI key stays yoursEncrypted in your system's vault, not on the server.
  • Works offlineWith the project saved on your machine, everything syncs later.
  • VS Code extensionsYour themes, snippets and extensions come with you.
  • Updates itselfNew versions download in the background.
Download for WindowsSign in on the web

Windows 10 and 11 (64-bit) · macOS and Linux coming soon