🌐 EvoScientist WebUI

The desktop-level browser workspace for EvoScientist, designed to make Vibe Research feel natural. By bringing evolving memory, research skills, multi-agent workflows, and workspace management together in one place, it helps researchers spend less time managing information and more time exploring ideas — so scientific discovery can move faster.

[!TIP] Looking for the engine behind this UI? Check out EvoScientist — the multi-agent AI scientist — and EvoSkills, its ready-to-use research skill packs. This WebUI is a thin, zero-touch client: it talks to a running EvoScientist deployment over the LangGraph SDK and adds nothing to your backend.

✨ Features

• 💬 Streaming Chat — Real-time responses with Markdown, GFM tables, math (KaTeX), code highlighting, zoomable Mermaid diagrams, and collapsible thinking/reasoning blocks.
• 🧬 Per-Thread Model Picker — Switch models per conversation with the /model command or a clickable model pill; the choice is persisted to the thread and folded into the next run.
• 👋 Human-in-the-Loop — Approve / reject / edit tool calls, and answer the agent's structured questions (text + multiple-choice) inline.
• ⚡ Per-Thread Auto-Approve — Persisted per conversation; survives view and thread switches and reloads.
• ⌨️ Message Queue — Type while the agent is busy: queue, edit, reorder, steer, or drain follow-up messages without interrupting the active run.
• 🤖 Sub-Agent Activity — Live step tracking for sub-agents, rendered exactly like the main agent (tool calls + paired results + tables).
• 🗂️ Workspace Browser — Tree and by-type (Papers / Figures / Data / Code) views with preview, edit, download, and zip-all.
• 🔗 Click-to-Open File Links — File paths in agent output are clickable — open them straight from chat in a workspace or memory viewer.
• 🧠 EvoMemory Browser — EvoScientist's global cross-session memory across three tabs: Identity (editable profile files), Knowledge (an interactive force-directed observation graph), and History (execution + observation timeline).
• ⏰ Scheduled Tasks — Schedule recurring research runs (daily / weekly / monthly / custom cron) with a visual builder, templates, and Run-now — backed by LangGraph crons.
• 📊 Research Dashboard — The chat's empty state surfaces recent memory activity, scheduled tasks, threads, and files, with one-click jump-in.
• 🔌 Skills Marketplace — Install, update, and uninstall the official EvoSkills catalog with version detection and a detail dialog.
• 📡 Agents Monitor Board — Watch async background agents (writing / data-analysis) with real run status, live duration, and a side-chat for direct worker debugging.
• 🔁 Async Agent Communication — Optional per-thread auto-report loops finished background results back to the main agent.
• 🪄 Compaction Summary — When the backend compacts a long conversation, the summary is shown as a clean collapsible block instead of flashing by.
• 🩺 Connection Health & Resilience — Health light, stale-URL one-click reconnect, and refresh-resumable streams.
• 🎨 Themed & Responsive — Light/dark warm "paper" theme with EvoScientist cyan accent; desktop split panes and mobile drawers.

📖 Table of Contents

• ✨ Features
• 📦 Prerequisites
• ⚡ Quick Start
• 🔑 Configuration
• 🎨 Designed By
• 🤝 Contributing
• 📚 Acknowledgments
• 📜 License

📦 Prerequisites

• EvoScientist installed and configured (EvoSci onboard).
• Node.js 20.9+ for Option B. Option A with EvoScientist v0.3.6 or later uses your Node.js if it is 20.9 or newer with npx installed next to it, and otherwise installs its own. With older versions, keep the Node.js on your PATH at 20.9 or newer (v0.3.4 and older need it).

⚡ Quick Start

Option A — via EvoScientist (recommended)

The WebUI ships with EvoScientist — just pick it during setup. Run the onboarding wizard and choose WebUI as your UI mode:

EvoSci onboard        # select "WebUI" when asked for the UI mode

Then launch EvoScientist as usual — it starts the backend and the WebUI together and opens your browser:

EvoSci                # opens http://localhost:4716

From EvoScientist v0.3.6, EvoSci setup (or the first WebUI launch) installs the newest compatible WebUI release on your machine, and later launches start it offline. Once a day, a launch also checks in the background for a newer compatible release and downloads it; the next launch checks it and switches to it. Run EvoSci setup to update right away.

That's it — start chatting.

Option B — standalone

Start the EvoScientist backend in one terminal:

EvoSci deploy         # serves the LangGraph API at http://127.0.0.1:6174

Then launch the WebUI in another (no install required):

npx @evoscientist/webui@latest                  # opens http://localhost:4716
npx @evoscientist/webui@latest --port 5000      # or pick a custom front-end port

Open the URL, confirm the prefilled Deployment URL (auto-detected, default http://127.0.0.1:6174), click Save, and start chatting.

🔝Back to top

🔑 Configuration

• Deployment URL — the EvoScientist LangGraph endpoint (default http://127.0.0.1:6174, the EvoSci deploy default port). Saved in your browser's local storage.
• The UI always talks to the EvoScientist main agent; its sub-agents (writing-agent, data-analysis-agent) are internal and not user-selectable.
• (Optional, advanced) Set NEXT_PUBLIC_LANGSMITH_API_KEY if you connect to a deployment that requires LangSmith authentication.

[!TIP] If the backend changes ports, the health light detects the dead connection and offers a one-click Reconnect to the newly detected port.

🔝Back to top

🎨 Designed By

Xi Zhang

🔝Back to top

🤝 Contributing

We welcome contributions! See the Contributing Guidelines for development setup, project structure, the zero-touch-backend principle, and scripts.

Every contribution brings us one step closer to a future where AI accelerates scientific breakthroughs for all of humanity.

🔝Back to top

📚 Acknowledgments

This project builds upon the following outstanding open-source work:

• LangGraph — A low-level orchestration framework for building, managing, and deploying long-running, stateful agents.
• deep-agents-ui — The LangChain reference UI for deep agents, which this project builds upon.

We thank the authors for their valuable contributions to the open-source community.

🔝Back to top

📜 License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

🔝Back to top