Leyou Studio

Auctus Agent

Open-source AI assistant, running on your own computer

Auctus Agent is a local-first desktop agent for macOS and Windows. It works with your files, asks before using sensitive tools, keeps data on your machine by default, and lets you choose between Leyou Studio's hosted API or your own OpenAI / Anthropic / DeepSeek compatible key.

Download for macOS Download for Windows View source on GitHub
Standalone download No Python setup macOS / Windows Local-first data Hosted API or BYO key Open source · AGPL-3.0

Why Auctus Agent

What makes it useful

Local-first by default

Your conversation history, generated files, memory candidates and tool logs stay on your own computer unless you choose a hosted API or external model provider.

Works with real files

Ask it to read, create, edit and organize local files. It can also ask where you want new files stored, so outputs do not disappear deep inside a project folder.

Controlled tools

File access, terminal commands, browser work, email and calendar capabilities are permissioned. You can keep the agent limited to a workspace or grant broader access.

Choose your model route

Use Leyou Studio hosted API for the simplest setup, or bring your own OpenAI, Anthropic, DeepSeek, DashScope or compatible model key.

Open source and auditable

The desktop core is published on GitHub under AGPL-3.0, so you can review how the agent, tools, memory and local web UI work.

Desktop plus mobile path

The desktop agent can pair with Auctus Agent Mobile through a relay, letting you send tasks to the computer from your phone when configured.

Downloads

Download the installer package

These are direct standalone package links. Download the ZIP for your system, extract it, then run the launcher inside. Current public download on this page: macOS v0.1.44 and Windows v0.1.44.

Install Notes

Detailed installation flow

01

Download the ZIP

Use the macOS or Windows download button above. If your browser warns that the file is uncommon, keep it only if you intentionally downloaded it from this page.

02

Extract to a stable folder

Move the ZIP to a normal folder and extract it there. Suggested locations: ~/Applications/Auctus-Agent on macOS or C:\Users\<you>\Apps\Auctus-Agent on Windows.

03

Run the launcher

macOS: double-click Launch Auctus Agent.command. Windows: double-click Launch Auctus Agent.bat. Keep the terminal window open while it starts.

04

Open the local UI

The browser should open automatically. If not, visit http://127.0.0.1:8000 after the terminal says the app is ready.

05

Complete first-run setup

In the local Web UI, choose your model provider, language and permissions scope. If you use the hosted service, sign in to your Auctus API account and the key is configured automatically.

06

Start with a small task

Try a low-risk request first, such as creating a note on your Desktop or summarizing a test file, so you can confirm permissions and output locations.

Security Warnings

If your system flags the app on first launch

Auctus Agent is currently distributed without a paid code-signing certificate, so both Windows SmartScreen and macOS Gatekeeper may show a warning the first time you run it. The source code is fully open on GitHub for independent review, and our Code Signing Policy documents how releases are built and signed. Below is exactly what to do for each platform.

Windows · "Windows protected your PC" / SmartScreen

  1. Right-click the downloaded Auctus-Agent-win-standalone-v0.1.44.zip → Properties → tick Unblock at the bottom of the General tab → OK. Do this before extracting.
  2. Extract the ZIP to a stable folder (e.g. C:\Users\<you>\Apps\Auctus-Agent). Avoid C:\Program Files and the Downloads folder.
  3. Double-click Launch Auctus Agent.bat.
  4. If SmartScreen pops up with "Windows protected your PC", click More info, then click Run anyway.
  5. If Microsoft Defender removes the file, open Windows Security → Virus & threat protection → Protection history, find the Auctus Agent entry, choose Actions → Allow, then re-extract and launch again.

Why this happens: the executable is not yet code-signed, so Windows has no reputation data for it. You can review the source on GitHub before allowing it.

Windows · Anti-virus software quarantines the file

  1. Open your anti-virus dashboard (Defender, 360, Huorong, Kaspersky, etc.).
  2. Find the quarantine / protection history entry for Auctus-Agent.
  3. Choose Restore and add the extracted folder to the trusted / exclusion list.
  4. Re-extract the ZIP if the original files were deleted, then launch again.

macOS · "cannot be opened because Apple cannot check it for malicious software"

  1. Extract the ZIP to a stable folder (e.g. ~/Applications/Auctus-Agent).
  2. Double-click Launch Auctus Agent.command. macOS will block it on first run.
  3. Open System Settings → Privacy & Security, scroll to the bottom, find the line about Launch Auctus Agent.command, and click Open Anyway.
  4. Double-click the launcher again, then click Open in the confirmation dialog.

Alternative: Control-click Launch Auctus Agent.command → Open → confirm. This only needs to be done once per machine.

macOS · "is damaged and can't be opened"

This is the macOS quarantine attribute on downloaded files. Open Terminal, then run:

xattr -dr com.apple.quarantine ~/Applications/Auctus-Agent

Replace the path with the actual extract location. Launch the agent again afterwards.

Setup

Connecting to the Auctus API

If you use the hosted API from Leyou Studio, pick Auctus API during the first-run setup or in the Settings page, then sign in with your Auctus API account. The agent will automatically create and store a personal API key for that account — you won't need to re-enter it on subsequent launches.

If you bring your own model key, choose "Bring your own key / OpenAI-compatible" in Settings, then fill in the provider's Base URL, API Key and model name. If unsure, start with the hosted Auctus API.

AUCTUS_API_BASE=http://120.24.223.0 AUCTUS_API_KEY=au_xxx (auto-generated on first sign-in)

Open Source

Source code · Build it yourself

The Auctus Agent desktop core (FastAPI service, agent tool loop, Web UI, memory and self-learning loop) is open source under the AGPL-3.0 license. You can audit, modify, contribute, or fork it for your own product.

git clone https://github.com/ddjiang327/auctus-agent.git cd auctus-agent && bash scripts/install_mac.sh

github.com/ddjiang327/auctus-agent →

Support

Troubleshooting

The browser didn't open after launch

Wait 10–20 seconds. If it still doesn't open, check the terminal window for errors and try visiting http://127.0.0.1:8000 manually.

I don't know which API key to enter

When using the hosted Auctus API, simply sign in during first-run setup or in Settings — the key is created and stored for you. Manual entry is only required when you bring your own model provider key.

The agent starts but the Web UI is blank

Refresh the page once. If the issue persists, fully close the terminal window, then re-launch the .command / .bat file. Some browsers cache an earlier error page.

Contact support

Email ruoya327@163.com with your OS version, agent version, a screenshot of the terminal window, and the steps to reproduce.

Status

Current release

  • Current public build: macOS v0.1.44, Windows v0.1.44.
  • Standalone packaging — Python is bundled, so users don't need to install it separately. Extract and run.
  • This download page can be used as AGENT_DOWNLOAD_URL by Auctus API.