Repository: miurla/morphic

Stars: 8770

CLAUDE.md Copy Chapter

AGENTS.md

README.md Copy Chapter

<div align="center">

Morphic

An AI-powered search engine with a generative UI.

  

<a href="https://vercel.com/oss">
<img alt="Vercel OSS Program" src="https://vercel.com/oss/program-badge.svg" />
</a>

<br />
<br />

<a href="https://trendshift.io/repositories/9207" target="_blank"><img src="https://trendshift.io/api/badge/repositories/9207" alt="miurla%2Fmorphic | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>

<img src="./public/screenshot-2026-02-07.png" />

</div>

Features Copy Chapter

- AI-powered search with GenerativeUI
- Search modes: Quick and Adaptive
- Model selector with dynamic provider detection (OpenAI, Anthropic, Google, Ollama, Vercel AI Gateway)
- Multiple search providers (Tavily, SearXNG, Brave, Exa)
- Chat history stored in PostgreSQL
- Share search results with unique URLs
- File upload support
- User authentication with Supabase Auth
- Guest mode for anonymous usage
- Docker deployment ready

Installation Copy Chapter

Docker (Recommended) Copy Section

The quickest way to run Morphic locally:

docker pull ghcr.io/miurla/morphic:latest

Then set up with Docker Compose:

1. Clone the repository and configure environment:

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:

OPENAI_API_KEY=your_openai_key

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

3. Start all services:

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 Copy Section

1. Clone and install:

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

2. Configure environment:

cp .env.local.example .env.local

Edit .env.local and set your API keys:

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.

3. Start the dev server:

bun dev

Visit http://localhost:3000.

Deploy Copy Chapter

Vercel Copy Section


Contributing Copy Chapter

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

License Copy Chapter

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