Eigent

Eigent: Install and first job

This page takes you from download to your first safe job, on Windows 11 or on a Mac, and it is the second of eight pages on Eigent. Do every step of "Turn on the safety switches first" before you type a job, even if the install already worked.

Install on Windows 11

1. Download the installer

Open the official release page for version 1.0.7, published 30 October 2026:

https://github.com/eigent-ai/eigent/releases/tag/v1.0.7

Scroll down to Assets and download Eigent.Setup.1.0.7.exe. It is large, about 1 GB, so give it a few minutes.

The official download page, https://www.eigent.ai/download, has the same choice under Windows (x64). That page does not show a version number, which is why this guide points to the release page instead.

The only Windows file is for x64 computers, and this guide could not confirm whether it runs on Windows PCs with an ARM chip.

What you should see a downloaded file named Eigent.Setup.1.0.7.exe, about 1 GB.

2. Run the installer

Open the file. The official install page says to "follow the on-screen instructions."

If Windows asks to run it as an administrator, say no. This guide could not confirm whether Windows shows a security warning for this installer.

What you should see the installer finishes, and Eigent is in your Start menu.

3. Open Eigent and log in

Open Eigent from the Start menu, then log in, or create an Eigent account if you do not have one.

This guide could not confirm what the sign-up form asks for, or whether it asks for a card. Do not buy a plan or credits, because you do not need them for this guide.

Stop after you log in, and do not type a job yet. Read "Turn on the safety switches first" below.

What you should see you are logged in, and Eigent shows its Home page.

Install on a Mac

1. Download the right file

You need macOS 11 (Big Sur) or newer, as the official install page says.

Open the official release page for version 1.0.7:

https://github.com/eigent-ai/eigent/releases/tag/v1.0.7

Under Assets, pick the file for your Mac's chip:

If you are not sure which you have, open the Apple menu and choose About This Mac. A line that says Chip with an Apple M name means Apple silicon, while a line that says Processor with Intel means Intel.

The official download page, https://www.eigent.ai/download, offers the same two choices as Mac (ARM64) and Mac (x64). ARM64 means Apple silicon, and x64 means Intel.

What you should see a downloaded file named Eigent-1.0.7-arm64.dmg or Eigent-1.0.7.dmg, about 630 to 680 MB.

2. Move it to Applications

Open the .dmg file and drag the Eigent icon into your Applications folder.

This guide could not confirm whether macOS shows a warning the first time you open Eigent.

What you should see Eigent in your Applications folder.

3. Open Eigent and log in

Open Eigent from Applications, then log in or create an Eigent account.

As on Windows, this guide could not confirm what the sign-up form asks for. Do not buy a plan or credits.

Stop after you log in, and read the next section before you type a job.

What you should see you are logged in, and Eigent shows its Home page.

If the app stalls while it starts, or the login never finishes, see Eigent: Fixes.

Turn on the safety switches first

Do this whole section before you give Eigent any job.

1. Make a new, empty folder and a Space for it

Make one new folder just for Eigent, for example eigent-tryout inside Documents. Put nothing personal in it, and copy in one harmless file, like a short note you typed yourself.

Eigent keeps your work in a Space, which can be connected to a folder on your computer. Create a new Space and connect it to your new folder. Do not connect it to your whole home folder, your whole Documents folder, or your Desktop.

The quick-start page says to "create a Space connected to a local folder," but this guide could not confirm the exact button names for that.

The folder is where Eigent works, but it is not a lock. Eigent's security policy says a command you approve can reach every file your account can reach.

What you should see a new Space connected to your new folder, with one harmless file in it.

2. Keep "Ask me first" on

Eigent has four approval modes, and you pick one for each Space using the picker in the chat box at the bottom of the screen. These are the names and descriptions from the app itself:

Mode What the app says
Read only "Eigent can read your files but cannot change anything."
Ask me first "Eigent asks for your approval before it changes anything."
Approve for me "Eigent approves routine steps and only asks about risky ones."
Full access "Eigent acts without asking. Use with care."

Read only is the strictest. Because it cannot write anything, it is too strict for your first job, but you can use it later for jobs that only need to read.

Ask me first is where a new Space starts in version 1.0.7, so keep it. Do not pick Approve for me, because Eigent would say yes for you on some steps. Never pick Full access, which the app says "acts without asking."

A change to the mode applies to new jobs, not to one that is already running.

When Eigent asks, you get these buttons:

Reading does not ask, even in Ask me first. A review by SafetyCard, an outside site rather than Eigent itself, says web searches and opening web pages also count as reading and run without asking.

What you should see Ask me first showing in the chat box for your new Space.

Stay logged out of email, your bank, and online stores in any browser Eigent can use, and do not connect email, chat, or other accounts as connectors yet.

Do not start a Remote Control link either. It lets anyone who has the link send commands to your computer, as explained in Eigent: Phone and schedules.

What you should see no email, bank, store, or chat account connected to Eigent, and no Remote Control link running.

4. Set a spend cap at the model provider

This guide found no monthly dollar limit inside Eigent, so the only money limit is at the provider that runs your model.

A free Gemini key with no card on file has no bill to cap. If you ever add a paid key, set a monthly limit on that provider's website first, before you paste the key into Eigent. The screen names for OpenAI and Anthropic are in the safety chapter.

Do not turn on Eigent Cloud models if you want to spend $0, because they use Eigent credits.

What you should see either a free key with no card, or a monthly limit saved at the paid provider.

Connect a model

Eigent will not start a job until at least one model works, as the models page says.

A free Gemini key (start here)

  1. Go to Google AI Studio and create an API key. You do not need a card, but Google may use free-tier prompts to improve its products.
  2. In Eigent, open Settings, and under Global Settings click Models.
  3. Scroll to the Custom Model area and click the Gemini card.
  4. Paste your key into API Key.
  5. Check API Host. The Eigent docs list https://generativelanguage.googleapis.com/v1beta/openai/ for Gemini and say this field is filled in for most providers.
  6. In Model Type, type a Gemini model name. The docs' example is gemini-3.5-flash.
  7. Click Save, and Eigent checks the key and the model.
  8. Click Set as Default.

This guide could not confirm which Gemini models a free key can use in Eigent today. If Save says "Invalid model name," try another model name from Google AI Studio, and if it says "Invalid key," copy the key again.

Do not paste your key into the chat.

What you should see the Gemini card saved and set as the default.

Or use a local model

Only pick this if your computer has lots of memory. Pick your model and budget explains why 8 GB and 16 GB computers are weak at jobs with many steps. Install Ollama and download a model first, using Run a local model with Ollama.

  1. In Eigent, open Settings, and under Global Settings click Models.
  2. In the row of provider icons at the top, click Ollama.
  3. Leave API key setting empty, because the app marks it optional for local models.
  4. Check that API host setting shows http://localhost:11434/v1, the usual address, which v1.0.7 fills in for Ollama.
  5. Under Model type setting, pick the model you downloaded from the list Eigent reads from Ollama.
  6. Click Save. Eigent then checks that the model supports tool calls, which it needs. If Save fails, pick a model that lists tools support on Ollama's site.
  7. At the top of the Models page, choose your Ollama model under Default model.

The provider page describes an older layout with a Local tab and the words "Validate and enable it," but the v1.0.7 app code uses the names above.

What you should see your Ollama model listed under Ollama on the Models page, and chosen under Default model.

Every agent in this guide reaches Ollama at port 11434, but the exact address differs: agents in Docker use host.docker.internal, and some need /v1 on the end. Connect it to your agent gives each one's address.

Your first safe job

Open your new Space and choose New session. Pick Single Agent for this first job, because it is easier to follow, and try Workforce later.

Check that the chat box still says Ask me first.

You can type:

Work only in this Space's folder. Read the one file in it. Then write a new short note in the same folder that sums it up. Do not use the web. Do not touch any other folder.

This job stays off the web on purpose, because web pages can hide instructions meant for the agent, and opening pages does not ask you first.

In version 1.0.7, an approval request shows up above the message box and names the file or command it is for, so read it before you click.

When it is done, open the folder yourself.

What you should see your original file, plus one new note. Nothing else should have changed.

Sources

Checked 14 November 2026.

Next

Continue to Eigent: Files, the browser, and memory.

Checked 14 November 2026 · prices, limits, and versions change