Y GuiFeatured

What is Y Gui?

Y Gui is a web-based graphical interface for AI chat interactions that supports multiple AI models and MCP (Model Context Protocol) servers. It runs on any modern browser and is built with a React frontend and a Cloudflare Workers backend, designed for developers and power users who want a customizable, self-hosted AI chat environment.

How to use Y Gui?

Clone the repository, install dependencies with npm install, configure environment variables (Auth0 and Cloudflare Worker settings in .env and wrangler.toml), then start the development server with npm run dev. To connect MCP servers, configure them via the UI with a name, command, arguments, environment variables, URL, and token. Multiple bot configurations (base URL, API key, model) can also be set up directly in the interface.

Key features of Y Gui

• 💬 Interactive chat interface with AI models
• 🤖 Support for multiple bot configurations (any base URL, API key, model)
• 🔗 MCP client support with multiple server configurations
• 🔒 Secure authentication via Auth0 and Google login
• 🌓 Dark/light theme support
• 🔄 Real-time updates with SWR

Use cases of Y Gui

• Chat with multiple AI models (e.g., OpenAI, local LLMs) from a single web UI.
• Equip AI assistants with external tools and data via MCP servers.
• Deploy a self-hosted, authenticated chat platform for teams or personal use.
• Access chat history across devices with cloud storage (Cloudflare KV/R2).
• Manage multiple bot configurations and MCP servers through a visual interface.

FAQ from Y Gui

What AI models does Y Gui support?

Y Gui works with any AI model accessible via an API, by configuring a base URL, API key, and model name. This includes OpenAI-compatible providers and self-hosted models.

How does authentication work?

Authentication uses Auth0 with universal login and Google social login, providing token-based session management for secure API access.

What is MCP server support and how do I configure it?

MCP servers allow the AI to use external tools and context. You configure them in the UI with a name, command, arguments, environment variables, URL, and token. Multiple servers can be active simultaneously.

Where is my chat data stored?

Chat data is stored in Cloudflare KV, with backups in Cloudflare R2. Bot and MCP server configurations are also stored in R2. All data is synced for access from any device.

Is Y Gui free and open source?

Y Gui is licensed under the MIT License. The software itself is free, but you need your own Cloudflare account (for Workers, KV, R2) and Auth0 account, which may incur costs depending on usage.