Morphic

An AI-powered search engine with a generative UI.

🗂️ Overview

• 🛠 Features
• 🧱 Stack
• 🚀 Quickstart
• 🌐 Deploy
• 🔎 Search Engine
• 💙 Sponsors
• 👥 Contributing
• 📄 License

📝 Explore AI-generated documentation on DeepWiki

🧪 Try v1.0.0 Beta

Want to experience the next generation of Morphic? The v1.0.0 beta is now available at beta.morphic.sh!

This major update includes exciting new features like advanced search modes, PostgreSQL database, enhanced UI, and much more. Learn more about what's new in Issue #680.

Your feedback helps shape the future of Morphic!

🛠 Features

Core Features

• AI-powered search with GenerativeUI
• Natural language question understanding
• Multiple search providers support (Tavily, SearXNG, Exa)
• Model selection from UI (switch between available AI models)
  • Reasoning models with visible thought process

Authentication

• User authentication powered by Supabase Auth
• Supports Email/Password sign-up and sign-in
• Supports Social Login with Google

Chat & History

• Chat history functionality (Optional)
• Share search results (Optional)
• Redis support (Local/Upstash)

AI Providers

The following AI providers are supported:

• OpenAI (Default)
• Google Generative AI
• Azure OpenAI
• Anthropic
• Ollama
• Groq
• DeepSeek
• Fireworks
• xAI (Grok)
• OpenAI Compatible

Models are configured in public/config/models.json. Each model requires its corresponding API key to be set in the environment variables. See Configuration Guide for details.

Search Capabilities

• URL-specific search
• Video search support (Optional)
• SearXNG integration with:
  • Customizable search depth (basic/advanced)
  • Configurable engines
  • Adjustable results limit
  • Safe search options
  • Custom time range filtering

Additional Features

• Docker deployment ready
• Browser search engine integration

🧱 Stack

Core Framework

• Next.js - App Router, React Server Components
• TypeScript - Type safety
• Vercel AI SDK - Text streaming / Generative UI

Authentication & Authorization (Updated Category)

• Supabase - User authentication and backend services

AI & Search

• OpenAI - Default AI provider (Optional: Google AI, Anthropic, Groq, Ollama, Azure OpenAI, DeepSeek, Fireworks)
• Tavily AI - Default search provider
• Alternative providers:
  • SearXNG - Self-hosted search
  • Exa - Neural search
  • Firecrawl - Web, news, and image search with crawling, scraping, LLM-ready extraction, and open source.

Data Storage

• Upstash - Serverless Redis
• Redis - Local Redis option

UI & Styling

• Tailwind CSS - Utility-first CSS framework
• shadcn/ui - Re-usable components
• Radix UI - Unstyled, accessible components
• Lucide Icons - Beautiful & consistent icons

🚀 Quickstart

1. Fork and Clone repo

Fork the repo to your Github account, then run the following command to clone the repo:

git clone git@github.com:[YOUR_GITHUB_ACCOUNT]/morphic.git

2. Install dependencies

cd morphic
bun install

3. Configure environment variables

cp .env.local.example .env.local

Fill in the required environment variables in .env.local:

# Required for Core Functionality
OPENAI_API_KEY=     # Get from https://platform.openai.com/api-keys
TAVILY_API_KEY=     # Get from https://app.tavily.com/home

For optional features configuration (Redis, SearXNG, etc.), see CONFIGURATION.md

4. Run app locally

Using Bun

bun dev

Using Docker

docker compose up -d

Visit http://localhost:3000 in your browser.

🌐 Deploy

Host your own live version of Morphic with Vercel, Cloudflare Pages, or Docker.

Vercel

Docker Prebuilt Image

Prebuilt Docker images are available on GitHub Container Registry:

docker pull ghcr.io/miurla/morphic:latest

You can use it with docker-compose:

services:
  morphic:
    image: ghcr.io/miurla/morphic:latest
    env_file: .env.local
    ports:
      - '3000:3000'
    volumes:
      - ./models.json:/app/public/config/models.json # Optional: Override default model configuration

The default model configuration is located at public/config/models.json. For Docker deployment, you can create models.json alongside .env.local to override the default configuration.

🔎 Search Engine

Setting up the Search Engine in Your Browser

If you want to use Morphic as a search engine in your browser, follow these steps:

1. Open your browser settings.
2. Navigate to the search engine settings section.
3. Select "Manage search engines and site search".
4. Under "Site search\