legion_web

# LegionWeb

[![License](https://img.shields.io/hexpm/l/legion_web.svg)](https://github.com/software-mansion-labs/legion_web/blob/main/LICENSE)
[![Version](https://img.shields.io/hexpm/v/legion_web.svg)](https://hex.pm/packages/legion_web)
[![Hex Docs](https://img.shields.io/badge/documentation-gray.svg)](https://hexdocs.pm/legion_web)

![LegionWeb Dashboard](https://raw.githubusercontent.com/software-mansion-labs/legion_web/main/img/preview.png)

Real-time dashboard for [Legion](https://github.com/software-mansion-labs/legion) agents. Shows agent lifecycle, LLM requests, code execution, and results as they happen.

## Installation

Add `legion_web` to your dependencies alongside `legion`:

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

Then run the installer:

```bash
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:

```elixir
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.

```elixir
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:

```bash
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](https://swmansion.com/?utm_source=git&utm_medium=readme&utm_campaign=legion_web) 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](https://swmansion.com/contact/projects).

Copyright 2026, [Software Mansion](https://swmansion.com/?utm_source=git&utm_medium=readme&utm_campaign=legion_web)

[![Software Mansion](https://logo.swmansion.com/logo?color=white&variant=desktop&width=200&tag=legion_web-github)](https://swmansion.com/?utm_source=git&utm_medium=readme&utm_campaign=legion_web)

## License

MIT License - see [LICENSE](LICENSE) for details.