Download and install Assista IDE
Install Assista IDE on Windows, macOS or Linux, then sign in and set up your first Odoo project. Installing the IDE takes a few minutes. Setting up Odoo needs a few more tools. See the prerequisites.
Supported platforms
| Platform | Requirement | Installer |
|---|---|---|
| Windows | Windows 10 or later, 64-bit (x64) | Installer (.exe) |
| macOS | macOS 12 or later, Apple Silicon | Disk image (.dmg) |
| Linux | Ubuntu 20.04 or later, 64-bit | Snap package |
Download Assista IDE from the download page. It has the current installer for each platform.
Install
- Download the Windows installer from the download page.
- Run the installer and follow the prompts. The installer can add the
cybrosys-assistacommand to your PATH. Leave that option on if you want to open projects from a terminal. - Start Cybrosys Assista from the Start menu.
If Windows warns you
The Windows installer is not yet code-signed, so Windows SmartScreen can show "Windows protected your PC". Select More info, then Run anyway.
Update: Assista IDE on Windows does not update itself. Download the newest installer and run it over your current installation. The installer closes a running Assista IDE before it updates.
Uninstall: open Settings > Apps > Installed apps, find Cybrosys Assista, then select Uninstall.
Your settings and data
Assista IDE keeps your settings and extensions in a .cybrosys-assista folder in your home folder. Uninstalling the IDE does not delete it. Delete that folder yourself to remove your settings.
Sign in
The first time you start Assista IDE with no folder open, the setup wizard opens and asks you to sign in with your Assista account.
- Select Login with Google, or select More ways to sign in to use another method.
- Your browser opens the Assista sign-in page. Sign in there.
- Your browser hands you back to Assista IDE, and the wizard continues.
Signing in turns on Assista's hosted models in Assista Coder. Sign-in is optional. Select Skip and continue to use the IDE without an account and add your own API key later.
If you do not finish signing in within 5 minutes, the attempt times out. Select the sign-in button again to restart it.
Troubleshooting
| What you see | Fix |
|---|---|
| "Login timed out" | You did not finish signing in within 5 minutes. Select the sign-in button again |
| "Authentication Failed" with a message about the portal | Try signing in again. If it keeps failing, use More ways to sign in or skip sign-in |
| The browser does not return to the IDE after you sign in | Make sure Assista IDE is still open. Your browser may ask whether to open cybrosys-assista. Allow it |
snap: command not found on Linux | Install Snap for your distribution, then run the install command again |
| Windows SmartScreen blocks the installer | Select More info, then Run anyway |
| The Snap install seems to hang | Snap downloads the package first. Wait for it to finish. Run snap changes to see progress |
| Running as root on Linux is refused | Run the IDE as your normal user. If you must use root, pass a --user-data-dir folder |
For anything else, see Support and include your operating system and the IDE version.
Next steps
- Install the prerequisites for the Odoo versions you work on.
- Walk through the first-run setup wizard.
- Set up your Odoo environment.