Get Atlas up and running

Download Atlas

Download Atlas-linux.zip to your Linux computer.

The current download is split into three parts. If your browser asks whether it is okay to download multiple files, allow the downloads.

After downloading the three parts, you should have these three files in your Downloads folder:

• Atlas-linux-split.zip
• Atlas-linux-split.z01
• Atlas-linux-split.z02

Make sure all three files are in the same folder. Your Downloads folder is fine.

Combine the three files

1. Open your Downloads folder.
2. Right-click an empty area inside the folder.
3. Choose Open in Terminal.
   If you don't see this option, open the Terminal app from your applications menu instead.
4. A window with text will appear. This is the Terminal.
5. Copy and paste the command below into the Terminal, then press Enter:

zip -F Atlas-linux-split.zip --out Atlas-linux-full.zip

6. Wait for the command to finish. A new file called Atlas-linux-full.zip should appear in your Downloads folder. This combines the three downloaded parts back into one complete file that you can extract and install.
7. Right-click Atlas-linux-full.zip and choose Extract Here.
8. Open the extracted Atlas folder and continue with the installation instructions below.

Run the Atlas installer

Open a Terminal (same way as above) inside the Atlas folder and run the installer:

./install.sh

The installer will set up the files Atlas needs on your computer.

Set up the local AI models

Atlas uses Ollama to run its local AI models. Make sure Ollama is installed and running on your computer, then download the models Atlas uses by opening the Terminal (same way as above) and running these commands.

curl -fsSL https://ollama.com/install.sh | sh

ollama pull phi3:mini

ollama pull mistral:7b

ollama pull deepseek-coder:6.7b

ollama pull llava

These models are used for different tasks, including everyday conversations, planning, code generation, and image or camera analysis.

Optional: Connect Google services when you first use them

Atlas can work with Google Calendar and Gmail. You do not need to enter your Google password into Atlas.

The first time you use an Atlas command that needs Gmail or Google Calendar, a Google sign-in page will open in your browser.

• Sign in to the Google account you want Atlas to use.
• Review the permissions Atlas is requesting.
• Allow access to the Gmail and/or Google Calendar features you want to use.

After authorization, Atlas can use the approved Google services without requiring you to enter your Google password into the application.

Optional: Connect Gemini

Atlas can use Google's Gemini models as an optional cloud-based AI service. You only need to complete this step if you want to use Gemini.

The first time Atlas needs Gemini, it will ask for a Gemini API key. You can create one through Google AI Studio.

Sign in with your Google account, create an API key, then copy the key and paste it into the Atlas text area labeled Type a command when prompted.

Optional: Connect Claude

Atlas can also use Anthropic's Claude models as an optional cloud-based AI service. You only need to complete this step if you want to use Claude.

Create a Claude API key

1. Open the Anthropic Console in your web browser and sign in or create an account.
2. Open the API key management area in the Console and choose the option to create a new API key.
3. Give the key a name that helps you remember what it is for, such as Atlas.
4. Create the key and copy it. Keep it somewhere secure while you complete the Atlas setup.

Anthropic's API uses prepaid usage credits. If your API account has not been funded yet, open the Billing area in the Anthropic Console and add usage credits before trying to use Claude through Atlas.

Once Atlas asks for your Claude API key, paste the key into the Atlas text area labeled Type a command when prompted.

Desktop setup complete

Start Atlas and make sure it is working on your computer before continuing with the phone setup below.

If you want Atlas to always remain visible on your screen, right-click where it says A.T.L.A.S and select Sticky window.

The Android app is a remote client. Atlas continues to run on your computer, while your phone sends commands to it and receives the responses.

Atlas Mobile can activate Atlas on your computer remotely. Your computer needs to be unlocked for the initial connection. After the connection is established, your computer can be locked.

Install Tailscale on your computer

Tailscale creates a private connection between your computer and phone. This allows the two devices to communicate without exposing Atlas directly to the public internet.

On your Linux computer, install Tailscale by opening the Terminal (same way as above) and copy/pasting this command:

curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up

Follow the sign-in instructions that appear.

Install Tailscale on your phone

Install the Tailscale app on your Android phone and sign in using the same Tailscale account you used on your computer.

Make sure Tailscale is turned on whenever you want your phone to connect to Atlas.

Install the Atlas Android app

Download Atlas.apk directly to your Android phone, or transfer the file from your computer to your phone.

Android may ask for permission to install an app from an unknown or third-party source. Allow the installation when prompted, then install Atlas.apk.

Generate your Atlas API key

Make sure Atlas is running on your computer.

In the Atlas desktop application, click the ⚙ Settings icon between Cancel and Mute.

Select:

Generate Mobile QR Code

Atlas will display a QR code containing your mobile API key. You will scan this code with the camera button next to the API Key field in the Android app.

Enter your Atlas connection settings

Open the Atlas Android app and go to Settings. You will need to enter four pieces of information:

1. Server URL — enter the address and port of the Atlas server running on your computer. See step 6 below to find the Tailscale IP address. The port, or last 4 digits is 8000 by default
   Example: http://xxx.xx.xxx.xx:xxxx
2. SSH Host — enter your computer's Tailscale IP address. See step 6 below.
   Example: xxx.xx.xxx.xx
3. SSH Username — enter the username you use to log in to your Linux computer.
4. API Key — use the camera button next to the API Key field to scan the QR code you generated in the previous step.

Install Tailscale and Find your Tailscale IP address

You need to find your computer's Tailscale IP address, open a Terminal on your computer and run:

pip install fastapi uvicorn qrcode Pillow --break-system-packages

openssl rand -hex 32 > ~/.config/atlas/api_key

chmod 600 ~/.config/atlas/api_key

tailscale ip -4

sudo apt install openssh-server

sudo systemctl enable --now ssh

Use the address shown by this command for both the SSH Host and, when appropriate, the IP portion of your Server URL.

Complete the first connection

Once your four settings are entered, save the settings and connect to Atlas.

During every connection, Atlas will ask for your Linux computer password to verify the connection and keep your data secure. We have no access to any data on your phone or computer.

Enter the same password you normally use to log in to your Linux computer.

You're all set

Once your phone is connected, you can use the Atlas Android app as a remote client for Atlas running on your computer.

Your computer needs to be powered on and unlocked for Atlas Mobile to connect. You can lock your computer after the connection is made.

The phone app does not run Atlas independently. Your desktop computer continues to handle the AI processing and Atlas's other capabilities.