# `mix adk.server`
[🔗](https://github.com/zeroasterisk/adk-elixir/blob/main/lib/mix/tasks/adk.server.ex#L1)

Starts an ADK development server with a browser-based chat UI.

Similar to Python ADK's `adk web` / `adk api_server`, this task launches
a local HTTP server so you can interact with your agent via a web browser
during development.

## Usage

    mix adk.server
    mix adk.server --port 4000 --agent MyApp.MyAgent
    mix adk.server --port 8080 --agent MyApp.MyAgent --model gemini-flash-latest

## Options

  * `--port` — HTTP port (default: `4000`)
  * `--agent` — Agent module name (default: builds a demo agent)
  * `--model` — LLM model to use (default: `gemini-flash-latest`)

## Endpoints

  * `GET /` — Chat UI (open in browser)
  * `GET /flow` — Agent flow visualizer (topology graph)
  * `GET /control` — Control plane dashboard (telemetry + BEAM metrics)
  * `POST /api/chat` — Send a message, get agent response
  * `GET /api/agent` — Agent info / card

## Example

    $ mix adk.server --port 4000 --agent MyApp.MyAgent
    ADK Dev Server running at http://localhost:4000
    Agent: MyApp.MyAgent (model: gemini-flash-latest)
    Press Ctrl+C to stop.

---

*Consult [api-reference.md](api-reference.md) for complete listing*