miurla /morphic

An AI-powered search engine with a generative UI

★ 9,333⑂ 2,376👁 64⑃ 798● 310▤ 86
TypeScriptApache-2.0Created 2024-04-05chat.morphic.sh
Download: v1.10.0v1.10.0 ↓1.10.02026-11-09
+4
Daily
9,333
stars
2,376
forks
64
watchers
798
prs
310
issues
86
releases

README

Morphic

An AI-powered search engine with a generative UI.

  


  











 Features

- AI-powered search with grounded, cited answers
- Generative UI — answers render rich inline components (source-credited images, grids, headings) live from a streamed JSON spec, beyond plain markdown
- Search modes: Quick and Adaptive
- Model selector with dynamic provider detection (OpenAI, Anthropic, Google, Ollama, Vercel AI Gateway, OpenAI-compatible providers)
- Multiple search providers (Tavily, SearXNG, Brave, Exa)
- Chat history stored in PostgreSQL
- Share search results with unique URLs
- File upload support
- User authentication with built-in accounts (Better Auth) or Supabase Auth
- Guest mode for anonymous usage
- Docker deployment ready

 Installation

 Docker (Recommended)

The quickest way to run Morphic locally:

bash
docker pull ghcr.io/miurla/morphic:latest


Then set up with Docker Compose:

1. Clone the repository and configure environment:

bash
git clone https://github.com/miurla/morphic.git
cd morphic
cp .env.local.example .env.local


2. Edit .env.local and set at least one AI provider API key:

bash
OPENAI_API_KEY=your_openai_key


See supported providers for other options (Anthropic, Google, Ollama, Vercel AI Gateway, OpenAI-compatible providers).

3. Start all services:

bash
docker compose up -d


4. Visit http://localhost:3000 and select your model from the model selector.

Docker Compose starts PostgreSQL, Redis, SearXNG, and Morphic automatically. No additional search API key is needed — SearXNG is included.

See the Docker Guide for more options including building from source and file upload configuration.

 Local Development

1. Clone and install:

bash
git clone https://github.com/miurla/morphic.git
cd morphic
bun install


2. Configure environment:

bash
cp .env.local.example .env.local


Edit .env.local and set your API keys:

bash
OPENAI_API_KEY=your_openai_key
TAVILY_API_KEY=your_tavily_key


To enable chat history, authentication, file upload, and other features, see CONFIGURATION.md.

For what a self-hosted instance sends outbound, and what is off by default, see PRIVACY.md.

3. Start the dev server:

bash
bun dev


Visit http://localhost:3000.

 Deploy

 Vercel



 Contributing

We welcome contributions! Please see our Contributing Guide for details on how to get started, including local development setup.

 License

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

Top issues

Latest release

v1.10.0 v1.10.0 2026-11-09
What's Changed
 fix(draft): keep editDraft off the draft for unrelated requests by @miurla in https://github.com/miurla/morphic/pull/1100
 feat(draft): merge the panel headers and move actions to a footer by @miurla in https://github.com/miurla/morphic/pull/1101
 fix(draft): keep the attached draft out of the moving prompt tail by @miurla in https://github.com/miurla/morphic/pull/1103
 chore: guard against vendor provider PRs by @miurla in https://github.com/miurla/morphic/pull/1105
 fix(deps): bump katex to 0.18 to resolve prototype pollution advisory by @miurla in https://github.com/miurla/m

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON