@vectorchat/webui

Beautiful chat interface for VectorChat - Open WebUI preconfigured and ready to use.

Features

• ✅ One-command launch - npx @vectorchat/webui
• ✅ Auto-configured - Pre-connected to VectorChat daemon
• ✅ No authentication - Uses VectorChat profile
• ✅ Local data - Stored in ~/.vectorchat-server/webui-data/
• ✅ No Docker - Standalone Python installation
• ✅ Auto-install - Installs Open WebUI if needed

Quick Start

1. Start VectorChat Daemon

npx @vectorchat/mcp-server daemon:start

2. Launch WebUI

npx @vectorchat/webui

That's it! Opens http://localhost:3000 automatically.

Installation

On-Demand (Recommended)

npx @vectorchat/webui

Pulls the package and runs it without permanent installation.

Global Install

npm install -g @vectorchat/webui
vectorchat-webui

Local Install

npm install @vectorchat/webui
npx vectorchat-webui

Configuration

The WebUI is pre-configured for VectorChat:

• API Base URL: http://localhost:3737/v1
• API Key: Not required (daemon handles auth)
• Data Directory: ~/.vectorchat-server/webui-data/
• Authentication: Disabled (uses VectorChat profile)
• Port: 3000

Architecture

┌─────────────────────┐
│  @vectorchat/webui  │  NPM package (on-demand)
└──────────┬──────────┘
           │ Installs & launches
           ▼
┌─────────────────────┐
│    Open WebUI       │  Port 3000
│  (Python package)   │
└──────────┬──────────┘
           │ HTTP /v1/chat/completions
           ▼
┌─────────────────────┐
│  VectorChat Daemon  │  Port 3737
│   (AI + EMDM)       │
└─────────────────────┘

Data Storage

All data is stored in your VectorChat profile:

~/.vectorchat-server/
├── webui-data/
│   ├── webui.db          # Chat history
│   ├── uploads/          # File uploads
│   └── cache/            # Model cache
├── models/               # AI models
└── daemon.log            # Daemon logs

Security

• ✅ No authentication - Simplified for local use
• ✅ Profile-based - Uses VectorChat user profile
• ✅ Local-only - Binds to localhost
• ✅ No Docker - Reduced attack surface
• ✅ User permissions - Runs as your user

Commands

# Start WebUI (auto-installs if needed)
npx @vectorchat/webui

# Or if globally installed
vectorchat-webui

# Install Open WebUI manually
npm run install-webui

Requirements

• Node.js 18+
• Python 3.8+
• VectorChat daemon running

Troubleshooting

WebUI won't start

1. Check daemon is running:

   curl http://localhost:3737/v1/models

2. If not, start it:

   npx @vectorchat/mcp-server daemon:start

Port 3000 already in use

Set a different port:

PORT=3001 npx @vectorchat/webui

Open WebUI installation fails

Install manually:

pip install open-webui --user

Uninstall

# Remove NPM package
npm uninstall -g @vectorchat/webui

# Remove Open WebUI
pip uninstall open-webui

# Remove data (optional)
rm -rf ~/.vectorchat-server/webui-data/

License

MIT

Links

• VectorChat
• Open WebUI