Free Agent Console: One Dashboard for Your AI Agent

If you’re running an AI agent without an Agent Console, you know the feeling. One terminal window for logs. Another tab for the chat. A third to check whether a cron job fired last night.

You built something useful, and the only way to check on it is to babysit four scattered windows at once.

Free Agent Console exists to close that gap. If that’s what brought you here, this is the tool: download the free Agent Console on GitHub.

If you only read one part of this

The free Agent Console is an open-source, single-file Python app from Perseon AI. It gives one AI agent a browser dashboard with chat, sessions, cron jobs, skills and voice. Hermes-first, read-only by default, single-agent only. Perseon Console is the paid step up.

Key Takeaways

  • Free and open source: MIT licensed. No account. No paywall on the core repo.
  • One single Python file: no frontend framework, no bundler and no database of its own.
  • Read-only by design: sessions, cron jobs and skills are viewable, not editable, from the console.
  • Built for one agent, on purpose: multi-agent management lives in Perseon Console, the paid tier.
  • Private by default: the README recommends Tailscale over exposing it to the public internet.

What Is an AI Agent Console?

You didn’t set out to become the person who checks four windows to know if your own agent is still alive. But that’s where things end up once an agent moves past a weekend project.

Agent Console is a free, single-agent dashboard built by Perseon AI. It gives one AI agent, a Hermes agent by default, a clean browser interface. No more operating it from terminals, chat threads, logs and local scripts.

The README puts the problem plainly: most agentic systems become capable before they become presentable. Agent Console gives that capability a front door, the same idea we cover in our guide to mission control for AI agents.

It’s not a framework, and it doesn’t run your agent for you. You bring the agent runtime. Agent Console gives it somewhere to live that isn’t a terminal window, and turns a script running quietly in the background into something you see and use.

Free Agent Console dashboard showing the COO cyan role theme

The COO theme, one of seven built-in role variants.


Free Agent Console: What You Get

Every panel in Agent Console maps to a real operational need, not a decorative dashboard widget.

Panel What it does
Runtime and status panel Shows safe profile metadata, gateway status and voice capability flags.
Chat surface Talk to your agent through the Hermes gateway, with streaming replies.
Mission surface An optional delegated task path. Off by default, and hardened against shell, file-write and MCP tool access when it’s on.
Sessions panel Read-only summaries of recent sessions from the selected profile.
Cron panel A read-only view of the agent’s scheduled jobs.
Skills panel A read-only inventory of the agent’s skills, scoped to safe namespaces.
Voice controls Browser speech fallback, plus optional ElevenLabs text-to-speech and transcription.
PWA support Install it to your phone’s home screen like a native app.

That last one matters more than it sounds. Agent Console is built mobile-first, not made responsive as an afterthought.


7 Role Themes, 1 Codebase

One detail worth knowing before you install: the same dashboard layout changes its role, avatar and accent colour based on the profile you select. There are seven built-in themes.

Theme Accent colour
CEO Green
COO Cyan
Assistant Gold
Developer Blue
Researcher Purple
Copywriter Orange
Reviewer Red

It’s a small touch. The same free Agent Console looks and feels like it belongs to whichever role your agent plays, instead of one generic grey dashboard for every use case.

★★★★★

“We’re not in this space whatsoever, we’re a childcare platform, but having this AI Agent Console has been an absolute dream. We’re seriously considering upgrading because it’s just been so worthwhile.”

The Au Pair Club

Agent Console: Mobile-First Operator Flow

Plenty of dashboards claim to be mobile-friendly and mean “it doesn’t break on a small screen”. Agent Console means something more specific.

On mobile, the list view is the main screen.

Free Agent Console with mobile file browser

Tap a session or a workspace file and the detail view slides in from the right, taking over the screen. That’s the pattern you’d expect from a native app, not a shrunk-down desktop site. Long lists scroll inside their own container, so the page stays still while you scroll through sessions or files.

The point isn’t novelty. With the free Agent Console, checking on an agent from your phone, mid-conversation or mid-commute, shouldn’t mean squinting at a desktop layout.


Add Agent Console to Your Phone’s Home Screen

It’s a proper PWA, a progressive web app, so you’re not only bookmarking a page.

Once it’s on your home screen, it opens full-screen, with no browser address bar, and behaves like any other app icon on your phone.

Getting it there takes under a minute, and the steps differ slightly by phone.

Platform Steps
iPhone (Safari) Open Agent Console in Safari, tap the Share icon at the bottom of the screen, scroll down and tap “Add to Home Screen”, then tap “Add” in the top right.
Android (Chrome) Open Agent Console in Chrome, tap the three-dot menu in the top right, tap “Install app” (or “Add to Home screen” on older versions), then confirm.

A few things worth knowing before you do this:

  • Use your private Tailscale URL, not the local one: if you install the 127.0.0.1 address, it only works while you’re on the same machine. Install the Tailscale address instead, so it works anywhere your phone has signal.
  • The icon behaves like a native app: no browser chrome, no address bar, only the dashboard, opening straight into the role theme you last selected.
  • It stays logged in: you’re not re-authenticating every time you tap the icon, the same way you wouldn’t log into a native app fresh every session.

This is the detail that makes the free Agent Console feel less like a self-hosted tool and more like something you reach for mid-commute, to check whether an overnight task finished without opening a laptop.

Try the Free Agent Console

No account, no paywall. Download it on GitHub and have your first agent dashboard running in about ten minutes.

Download Agent Console on GitHub →

What the Free Agent Console Deliberately Doesn’t Do

This is the section most tools bury or skip. Agent Console’s README states its limits upfront, and they’re worth taking seriously before you install it expecting something else.

It isn’t an agent framework, a SaaS starter kit or a broad multi-agent operations platform. You bring the runtime. It gives that one runtime a front end.

The free tier excludes:

  • A multi-agent production plugin stack
  • Advanced Kanban, backlog or workflow plugins
  • Production deployment packaging
  • Commercial Full Stack templates
  • Private Perseon personas, memory, prompts or internal operating canon
  • Credentials, logs, customer data or host-specific runtime state

If you’re managing more than one agent, this isn’t the tool for that job, and the README says so directly instead of letting you find out the hard way. Our guide to managing multiple AI agents covers what changes once you’re past one.


Free Agent Console: Deliberately Small

The architecture is worth a mention because it’s unusually restrained for a modern web app.

Layer What’s there
Frontend No framework, no bundler. HTML, CSS and JS live inside the single Python file.
Backend A Python standard library ThreadingHTTPServer, nothing exotic.
Database None owned by the app. It reads your existing Hermes profile’s state.db and cron/jobs.json.
Dependencies Python 3.11 or newer, and the requests package for outbound provider calls.

The whole repository is small enough to read before you customise it, which is rarer than it should be. Most tools this size ship with a framework and a build step attached.


Getting the Free Agent Console Running

  1. Clone the repo and create a local config: git clone https://github.com/Perseon-Lab/agent-console.git
  2. Set up a virtual environment and install the one dependency: pip install requests
  3. Run it locally: python3 agent_console.py
  4. Open it in your browser: http://127.0.0.1:4200
  5. Confirm it’s alive with a health check: curl -s http://127.0.0.1:4200/health

That’s the whole process for a local install.

✅ No account creation

✅ No onboarding flow


Keep It Private: The Tailscale Recommendation

Agent Console shows runtime status, sessions, cron jobs, skills and chat controls, so it sits right next to sensitive agent data. The README is direct about this: don’t put it straight on the public internet by default.

The recommended path is Tailscale, a private network that saves you configuring public firewall rules, reverse proxies or HTTPS certificates on day one.

Install Tailscale on the machine running Agent Console and on the device you check it from. Log into the same account on both, and you get a private URL only your own devices reach.

Getting an AI coding agent to install this for you?

The project’s own agent instructions default to private access first. A coding agent following the official prompts won’t expose the dashboard publicly unless you ask for it and approve the extra security work.

Upgrading to Perseon Console

The free Agent Console is the single-agent tier. It’s built to be useful on its own, not deliberately crippled to push an upgrade.

The moment your work grows past one agent, the ceiling shows quickly, usually right around the point agent sprawl starts creeping in.

Tier Best for and what it adds
Agent Console (free) Builders who want one agent out of the terminal and into a clean UI. Adds: a basic operating surface with status, sessions, cron jobs, skills and chat.
Perseon Console Core Builders who want a polished paid starting point. Adds: a broader app foundation, setup guide, branding and deployment guidance.
Perseon Console Full Stack Consultants, agencies and serious builders running more than one agent. Adds: multi-agent workflows, plugin-ready patterns, deeper docs and commercial packaging.
Perseon Console Install Sprint Buyers who want help installing it quickly. Adds: done-with-you setup and handoff support.

Get the Full Stack offer, or join the waitlist as the paid tiers roll out, through Perseon AI.


Frequently Asked Questions

Is Agent Console actually free?

Yes. It’s MIT licensed and hosted openly on GitHub. No account, no paywall and no feature gate on the core repo.

Is an AI Agent Console the same thing as an AI agent framework?

No. An AI agent framework is the runtime your agent thinks and acts through, a different layer entirely. An AI Agent Console sits on top of that. It’s the dashboard, not the engine.

Agent Console expects you to already have a running Hermes agent, and gives that agent a front end instead of replacing anything underneath it.

Does the free Agent Console only work with Hermes agents?

It ships Hermes-first, so the default profile selection, status surfaces and chat path are built around a local Hermes profile and gateway.

For other runtimes, the repo includes adapter prompts for Claude and OpenClaw, plus a generic prompt for custom runtimes. You paste them into a coding agent to port the runtime layer while keeping the existing UI.

Can it manage more than one agent?

No, and it’s explicit about that. It’s built for a single agent by design. Multi-agent management, Kanban workflows and shared knowledge bases live in Perseon Console, the paid tier.

Is it safe to expose it to the internet?

The project recommends against it by default. It shows real operational data, including runtime status, session summaries, cron jobs and skills. So the recommended setup runs it privately behind Tailscale, not on a public IP.

Can I edit my agent’s sessions, cron jobs or skills from the dashboard?

No. Those panels are read-only. The one exception is the optional mission surface, which is off by default and, even when on, is hardened against shell access, file writes and MCP tool access.

Do I need to be a developer to install Agent Console?

Basic comfort with the command line helps: cloning a repo, creating a virtual environment and running a Python script. There’s no drag-and-drop installer.

The setup is short, though, and the repo includes numbered prompts written so a coding agent installs it on your behalf.

What happens to my data if I use the voice features?

Voice has a browser speech fallback that needs no external service. ElevenLabs for text-to-speech and an OpenAI-compatible endpoint for transcription are both optional, and use your own API keys, not a Perseon-hosted service.


Our Verdict on the Free Agent Console

Agent Console does one job and says so plainly: it gives a single Hermes agent a real front door instead of a terminal window.

It doesn’t pretend to be more than that, and the README’s honesty about what it leaves out is rarer than it should be in this space. If you’re running one agent, it’s worth an evening to set up.

If you’re already past that, coordinating several agents across scattered tools, Perseon Console is the natural next step. Same team, built for the problem the free tool was never meant to solve.

Give Your Agent a Front Door

Free, open source and running in about ten minutes. One agent, one clean dashboard, no terminal juggling.

Download Agent Console on GitHub →

Shopping Cart
Scroll to Top
Secret Link

Complete The Form Below to Access Your FREE Strategy