Morphic

An AI-powered search engine with a generative UI.

Note

Please note that there are differences between this repository and the official website morphic.sh. The official website is a fork of this repository with additional features such as authentication, which are necessary for providing the service online. The core source code of Morphic resides in this repository, and it's designed to be easily built and deployed.

🗂️ Overview

• 🛠 Features
• 🧱 Stack
• 🚀 Quickstart
• 🌐 Deploy
• 🔎 Search Engine
• ✅ Verified models

🛠 Features

• Search and answer using GenerativeUI
• Understand user's questions
• Search history functionality
• Share search results (Optional)
• Video search support (Optional)
• Get answers from specified URLs
• Use as a search engine ※
• Support for providers other than OpenAI
  • Google Generative AI Provider
  • Anthropic Provider ※
  • Ollama Provider (Unstable)
• Specify the model to generate answers
  • Groq API support ※
• Local Redis support
• SearXNG Search API support

🧱 Stack

• App framework: Next.js
• Text streaming / Generative UI: Vercel AI SDK
• Generative Model: OpenAI
• Search API: Tavily AI / Serper / SearXNG
• Reader API: Jina AI
• Database (Serverless/Local): Upstash / Redis
• Component library: shadcn/ui
• Headless component primitives: Radix UI
• Styling: Tailwind CSS

🚀 Quickstart

1. Fork and Clone repo

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

git clone [email protected]:[YOUR_GITHUB_ACCOUNT]/morphic.git

2. Install dependencies

cd morphic
bun install

3. Setting up Upstash Redis

Follow the guide below to set up Upstash Redis. Create a database and obtain UPSTASH_REDIS_REST_URL and UPSTASH_REDIS_REST_TOKEN. Refer to the Upstash guide for instructions on how to proceed.

If you intend to use a local Redis, you can skip this step.

4. Fill out secrets

cp .env.local.example .env.local

Your .env.local file should look like this:

# OpenAI API key retrieved here: https://platform.openai.com/api-keys
OPENAI_API_KEY=

# Tavily API Key retrieved here: https://app.tavily.com/home
TAVILY_API_KEY=

# Upstash Redis URL and Token retrieved here: https://console.upstash.com/redis
UPSTASH_REDIS_REST_URL=
UPSTASH_REDIS_REST_TOKEN=

## Redis Configuration

This application supports both Upstash Redis and local Redis. To use local Redis:

1. Set `USE_LOCAL_REDIS=true` in your `.env.local` file.
2. Optionally, set `LOCAL_REDIS_URL` if your local Redis is not running on the default `localhost:6379` or `redis://redis:6379` if you're using docker compose.

To use Upstash Redis:

1. Set `USE_LOCAL_REDIS=false` or leave it unset in your `.env.local` file.
2. Set `UPSTASH_REDIS_REST_URL` and `UPSTASH_REDIS_REST_TOKEN` with your Upstash credentials.

5. Run app locally

Using Bun

To run the application locally using Bun, execute the following command:

bun dev

You can now visit http://localhost:3000 in your web browser.

Using Docker

To run the application using Docker, use the following command:

docker compose up -d

This will start the application in detached mode. You can access it at http://localhost:3000.

🌐 Deploy

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

Vercel

Cloudflare Pages

1. Fork the repo to your GitHub.
2. Create a Cloudflare Pages project.
3. Select Morphic repo and Next.js preset.
4. Set OPENAI_API_KEY and TAVILY_API_KEY env vars.
5. Save and deploy.
6. Cancel deployment, go to Settings -> Functions -> Compatibility flags, add nodejs_compat to preview and production.
7. Redeploy.

The build error needs to be fixed: issue

🔎 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.

Using SearXNG as an Alternative Search Backend

Morphic now supports SearXNG as an alternative search backend. To use SearXNG:

1. Ensure you have Docker and Docker Compose installed on your system.

2. In your .env.local file, set the following variables:

   • SEARXNG_API_URL=http://localhost:8080 # Replace with your local SearXNG API URL or docker http://searxng:8080
   • SEARXNG_SECRET=your_secret_key_here
   • SEARXNG_PORT=8080
   • SEARXNG_IMAGE_PROXY=true
   • SEARCH_API=searxng
   • SEARXNG_LIMITER=false # can be enabled to limit the number of requests per IP

3. Two configuration files are provided in the root directory:

• searxng-settings.yml: This file contains the main configuration for SearXNG, including engine settings and server options.
• searxng-limiter.toml: This file configures the rate limiting and bot detection features of SearXNG.

4. Run docker-compose up to start the Morphic stack with SearXNG included.
5. SearXNG will be available at http://localhost:8080 and Morphic will use it as the search backend.

Customizing SearXNG

• You can modify searxng-settings.yml to enable/disable specific search engines, change UI settings, or adjust server options.
• The searxng-limiter.toml file allows you to configure rate limiting and bot detection. This is useful if you're exposing SearXNG directly to the internet.
• If you prefer not to use external configuration files, you can set these options using environment variables in the docker-compose.yml file or directly in the SearXNG container.

Advanced Configuration

• To disable the limiter entirely, set LIMITER=false in the SearXNG service environment variables.
• For production use, consider adjusting the SEARXNG_SECRET_KEY to a secure, randomly generated value.
• The SEARXNG_IMAGE_PROXY option allows SearXNG to proxy image results, enhancing privacy. Set to true to enable this feature.

Troubleshooting

• If you encounter issues with specific search engines (e.g., Wikidata), you can disable them in searxng-settings.yml:

engines:
  - name: wikidata
    disabled: true

• refer to https://docs.searxng.org/admin/settings/settings.html#settings-yml

✅ Verified models

List of models applicable to all:

• OpenAI
  • gpt-4o
  • gpt-4o-mini
  • gpt-4-turbo
  • gpt-3.5-turbo
• Google
  • Gemini 1.5 pro (Unstable)
• Anthropic
  • Claude 3.5 Sonnet
• Ollama (Unstable)
  • mistral/openhermes & Phi3/llama3 ※

List of verified models that can be specified to writers:

• Groq
  • LLaMA3.1 8b
  • LLaMA3.1 70B
  • LLaMA3 8b
  • LLaMA3 70b