Repolode
Submit
u14app

u14app/neo-chat

A self-hostable, local-first AI chat workspace supporting multiple model providers, agents, Deep Research, RAG, skills, MCP, and voice.

Open-source alternative to:ChatGPTClaude

View on GitHubWebsite
Stars
1,879
Forks
624
Open issues
6
Last commit
23 hours ago

What is it?

Neo Chat is a web-based AI chat workspace that you can self-host. It connects to Google, OpenAI, Anthropic, and OpenAI-compatible endpoints using your own API keys, with image input and generation where the provider supports it.

Beyond everyday chat, it offers an Agent mode for multi-step tool workflows and a Deep Research mode that produces plans for review and cited reports. Users can attach files, query a knowledge base, keep memory, and save reusable assistant presets. Extensions come through text Skills, OpenAPI plugins, remote MCP servers, and an optional Docker bridge for local stdio MCP tools.

Conversations and workspace files are stored in the browser by default. ZIP backup and restore are included, and encrypted sync is available through WebDAV or S3/MinIO. The interface is available in English, Simplified Chinese, and Japanese, with desktop and mobile layouts. It can be deployed with Docker, Vercel, or Cloudflare Workers.

Key features

  • 01Connects to Google, OpenAI, Anthropic, and OpenAI-compatible model endpoints.
  • 02Agent mode runs multi-step tool workflows; Deep Research produces reviewable plans and cited reports.
  • 03Supports file attachments, knowledge-base retrieval, local search, and memory.
  • 04Extends through text Skills, OpenAPI plugins, and remote MCP servers.
  • 05Stores data in the browser by default, with ZIP backup and optional encrypted sync via WebDAV or S3/MinIO.

Use cases

  • Running a private, self-hosted chat front end over your own API keys for several model providers.
  • Chatting with your documents through knowledge-base retrieval and file attachments.
  • Running multi-step research tasks that produce cited reports for review.
  • Connecting internal OpenAPI services or MCP tools to a chat interface.

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/u14app/neo-chat.git
  2. 2

    Enter the project directory

    cd neo-chat
  3. 3

    Install dependencies (requires Node.js 24 and pnpm 10.30.3 via Corepack)

    corepack pnpm install --frozen-lockfile
  4. 4

    Start the development server, then open localhost:3000

    corepack pnpm dev

Things to know

  • Local setup needs Node.js 24 and pnpm 10.30.3, and a model provider API key is required to chat.
  • The Docker example uses ephemeral credential-encryption keys, so stable BYOK keys are needed before production use.
  • Agent and Deep Research runs stop when the page is closed and need explicit resume.

Topics

#ai-chat#llm#self-hosted#nextjs#mcp#rag#local-first#deep-research#ai#gemini

FAQ

What is neo-chat?
A self-hostable, local-first AI chat workspace supporting multiple model providers, agents, Deep Research, RAG, skills, MCP, and voice. Neo Chat is a web-based AI chat workspace that you can self-host. It connects to Google, OpenAI, Anthropic, and OpenAI-compatible endpoints using your own API keys, with image input and generation where the provider supports it.
Is neo-chat free to use? What license does it have?
neo-chat is open source under the MIT license. Check the license terms before using it in commercial products.
Is neo-chat still maintained?
Actively maintained. The last commit to neo-chat was on Oct 21, 2026.
What can I use neo-chat for?
Running a private, self-hosted chat front end over your own API keys for several model providers. Chatting with your documents through knowledge-base retrieval and file attachments. Running multi-step research tasks that produce cited reports for review. Connecting internal OpenAPI services or MCP tools to a chat interface.
How do I install neo-chat?
Clone the repository: git clone https://github.com/u14app/neo-chat.git Enter the project directory: cd neo-chat Install dependencies (requires Node.js 24 and pnpm 10.30.3 via Corepack): corepack pnpm install --frozen-lockfile Start the development server, then open localhost:3000: corepack pnpm dev
Where can I get neo-chat?
The source code and installation instructions are on GitHub: https://github.com/u14app/neo-chat

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects