Takes about 3 minutes

Setup Guide

See every screen of the onboarding wizard before you install. Fake API keys and example data included so you can follow along.

Watch the video walkthrough
1
Step 1 of 8

Welcome Screen

The first thing you see when you open localhost:3333 for the first time. Just hit "Get Started."

localhost:3333
Welcome to OpenAce
Your AI Executive Assistant
Ace handles business management, strategy, marketing, research, code, scheduling, and web browsing — all from one dashboard.
Get Started →
Tip: This screen only appears on your first visit. After setup, you go straight to the dashboard.
2
Step 2 of 8

Terms & Consent

Read through the terms and check the box. OpenAce is autonomous software that takes real actions, so you need to acknowledge this.

localhost:3333
📜
Terms & Consent

What OpenAce Can Do

OpenAce is an AI assistant that can browse the web, send emails, manage files, control your desktop, and execute automated tasks on your behalf.

Use at Your Own Risk

This software is provided "as-is." While safeguards are in place, unintended actions are possible.

Assumption of Risk

By using OpenAce, you accept responsibility for any actions it takes on your behalf.

Limitation of Liability

Liability is capped at $100 USD. Consequential damages are excluded.
I understand that OpenAce is an autonomous AI that takes real actions, and I accept the risks and terms above.
← Back
Continue →
Note: You must check the box before the Continue button activates. Scroll down in the terms box to read everything.
3
Step 3 of 8

System Setup & AI Provider

Choose your AI provider and paste your API key. We recommend Google Gemini — it's free to start.

localhost:3333
System Setup
✓ Node.js v22 ✓ Dependencies ✓ Server running ⚠ Ollama not found
Choose your AI provider
Google Gemini gemini-2.5-flash — free tier available
Recommended
🤖
OpenAI GPT-4.1 — powerful reasoning
💬
Anthropic (Claude) Claude Sonnet 4.6 — detailed analysis
🏠
Ollama (Local) Free — runs on your machine
Gemini API Key
Model
⚡ Test Connection
✓ Connected — Gemini is ready!
← Back
Continue →
How to get a free Gemini key: Go to aistudio.google.com/apikey → Click "Create API key" → Copy the key → Paste it here.

Ollama warning is OK. You only need Ollama if you want fully local AI. The warning won't block you.
4
Step 4 of 8

About You

Tell Ace your name and company so it can personalize emails, research, and outreach on your behalf.

localhost:3333
👤
About You
What's your name?
What's your company called?
← Back
Continue →
This data stays local. Your name and company are stored on your machine in data/ — nothing is sent to the cloud.
5
Step 5 of 8

Your Business

Help Ace understand your business so it knows your industry, audience, and what you offer. This powers smarter research and outreach.

localhost:3333
🏢
Your Business
Industry
What does your company do?
Who is your target audience?
Key offerings (comma-separated)
Location
Website
← Back
Continue →
Why this matters: When Ace researches leads, writes emails, or creates social media posts — it uses this profile to sound like YOU, not a generic AI. The more you fill in, the better.
6
Step 6 of 8

Telegram Setup (Optional)

Connect a Telegram bot if you want to chat with Ace from your phone. Skip this if you only use the web dashboard.

localhost:3333
📱
Telegram Setup
Chat with Ace from your phone!
How to get a Telegram bot token: 1. Open Telegram and search for @BotFather
2. Send /newbot and follow the prompts
3. Copy the bot token BotFather gives you
4. Paste it below
Bot Token
⚡ Test Token
✓ Bot connected: @MyAceBot
Skip this if you don't use Telegram — you can set it up later in Settings.
← Back
Continue →
100% optional. Most users skip this and just use the web dashboard at localhost:3333. You can always add Telegram later from Settings.
7
Step 7 of 8

Desktop Control

Enable Ace to operate your mouse, keyboard, and browser autonomously. macOS only — skip if you're on Windows or Linux.

localhost:3333
🖥
Desktop Control
Enable Desktop Control Allow Ace to operate your computer autonomously
🖱 Mouse Control ⌨ Keyboard 🌐 Browser
⚠️ Risk Warning

Desktop control allows Ace to move your mouse, type on your keyboard, and interact with apps. System apps (Terminal, System Preferences) are blocked by default. Safeguards are in place, but unintended actions are possible.

You can always change this later in Settings → Organization
← Back
Continue →
macOS only. This powers browser automation, SOP recording, and desktop tasks. Windows/Linux users can skip — all chat, research, email, CRM, and social features work without it.
8
Step 8 of 8

You're All Set!

Ace shows a summary of everything you configured and takes you straight to the dashboard.

localhost:3333
You're all set, Sarah!
Ace is ready to help you with Mitchell Property Group. Here's what's been configured:
AI Provider Google Gemini
🖥
Desktop Control ✓ Enabled
📱
Telegram ✓ Connected
Go to Dashboard →
That's it! You're now on the dashboard. Just type anything in the chat and start talking to Ace. Ask it to find leads, send emails, research competitors, schedule posts — anything.

Ready to install?

The whole setup takes about 3 minutes. One command installs everything.

Install OpenAce → Back to Home