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

🛠 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

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:

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

2. Install dependencies

1
cd morphic
2
bun install

3. Configure environment variables

1
cp .env.local.example .env.local

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

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

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

4. Run app locally

1
bun dev

1
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:

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

You can use it with docker-compose:

1
services:
2
  morphic:
3
    image: ghcr.io/miurla/morphic:latest
4
    env_file: .env.local
5
    ports:
6
      - '3000:3000'
7
    volumes:
8
      - ./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", click on "Add".
5. Fill in the fields as follows:
   • Search engine: Morphic
   • Shortcut: morphic
   • URL with %s in place of query: https://morphic.sh/search?q=%s
6. Click "Add" to save the new search engine.
7. Find "Morphic" in the list of site search, click on the three dots next to it, and select "Make default".

This will allow you to use Morphic as your default search engine in the browser.

💙 Sponsors

This project is proudly supported by:

👥 Contributing

We welcome contributions to Morphic! Whether it's bug reports, feature requests, or pull requests, all contributions are appreciated.

Please see our Contributing Guide for details on:

• How to submit issues
• How to submit pull requests
• Commit message conventions
• Development setup

📄 License

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