LegionWeb

Real-time dashboard for Legion agents. Shows agent lifecycle, LLM requests, code execution, and results as they happen.

Installation

Add legion_web to your dependencies alongside legion:

def deps do
  [
    {:legion, "~> 0.5"},
    {:legion_web, "~> 0.5"}
  ]
end

Then run the installer:

mix deps.get
mix legion_web.install

This adds the LegionWeb.Router import and mounts the dashboard at /legion in your Phoenix router.

Manual setup

If you prefer to set things up manually (or don't have Igniter installed), add the following to your router:

defmodule MyAppWeb.Router do
  use Phoenix.Router
  import LegionWeb.Router

  scope "/" do
    pipe_through :browser
    legion_dashboard "/legion"
  end
end

That's it. Start your app and visit /legion to see the dashboard.

Securing the dashboard

In production, make sure to protect the route with authentication. The dashboard exposes agent internals, LLM requests, and code execution traces.

scope "/" do
  pipe_through [:browser, :admin_auth]
  legion_dashboard "/legion"
end

If you use mix phx.gen.auth, pipe_through [:browser, :require_authenticated_user] works out of the box.

Development

To run the standalone dev server:

cd legion_web
mix deps.get
mix dev

This starts a Phoenix server at http://localhost:4001/legion with the Product Scout demo - a coordinator agent that asks what product you're looking for, then fans out to web-research and product-opinion sub-agents and synthesizes a report.

Requires an LLM API key — create a .env file:

OPENAI_API_KEY=sk-...

Authors

LegionWeb is created by Software Mansion.

Since 2012 Software Mansion is a software agency with experience in building web and mobile apps as well as complex multimedia solutions. We are Core React Native Contributors, Elixir ecosystem experts, and live streaming and broadcasting technologies specialists. We can help you build your next dream product – Hire us.

Copyright 2026, Software Mansion

License

MIT License - see LICENSE for details.