Introduction

ChatWalaʻau is the localhost AI Agent Runtime -- a modern chat UI, agent tools, a RAG pipeline, and MCP integration in a single pip install. It connects the UI to AI agents over the AG-UI protocol and exposes an OpenAI-compatible API, all running on your own machine by default.

pip install chatwalaau

Why ChatWalaʻau?

• One command, full stack -- Chat UI + Agent Runtime + Tools + RAG with no Docker and no cloud setup.
• Your data stays local -- File-based sessions, ChromaDB vectors, and uploads never leave your machine.
• MCP native -- Zero-config first run via bundled defaults; connect any MCP server, and MCP Apps render interactive UI inside chat.
• OpenAI-compatible API -- Expose your agent as /v1/responses for any app built on the OpenAI SDK.

Built on the Microsoft Agent Framework.

About the name

Walaʻau (wah-la-OW) is a Hawaiian word meaning "to chat, talk, or converse." We chose it because it captures what the agent does, in the language of the place where the project is built. Hawaiian (ʻōlelo Hawaiʻi) is an indigenous language now in active revitalization; we use this word with respect and gratitude.

Where to start

• Installation -- install and run.
• Configuration -- the .env settings you will actually use.
• Features -- everything the runtime can do.
• API & CLI -- use it from other apps and the terminal.

Supported platforms

• Windows 10/11
• macOS (Intel / Apple Silicon)
• Linux (Ubuntu, Debian, etc.)

Licensed under Apache-2.0.