Skip to content

micro/mu

Repository files navigation

mu

The Micro Network — apps without ads, algorithms, or tracking.

Overview

Mu is a place to browse the news, track markets, watch videos, search the web and more — all in one place, without ads, algorithms, or tracking.

Browsing is free. Searching, posting, and AI features use credits. You get 20 free credits per day, then pay as you go from 1p.

Services

  • Home — At a glance dashboard
  • Agent — Ask questions and get things done across every service
  • Social — Topic-based discussions and conversations
  • Blog — Write posts or read daily digests
  • Chat — Talk about any topic with AI-powered conversation
  • News — Headlines and articles with AI summaries
  • Mail — Message other users or send email
  • Video — Browse and search videos
  • Markets — Live crypto, futures & commodities
  • Web — Search the web without tracking
  • Wallet — Pay as you go with credits

Mu runs as a single Go binary on your own server or use the hosted version at mu.xyz.

Roadmap

  • API - Basic API
  • App - Basic PWA
  • Home - Overview
  • Agent - AI assistant
  • Blog - Daily digests
  • Chat - Discussion rooms
  • News - RSS news feed
  • Video - YouTube search
  • Mail - Private messaging
  • Markets - Live prices
  • Web - Web search, no Ads
  • Wallet - Card payments
  • Services - Marketplace, etc

AI Features

  • Blog — Daily digests generated from trending news
  • News — AI summaries of articles
  • Chat — AI-powered conversation on any topic
  • Agent — Searches news, markets, video and more to answer your questions

MCP — AI Agent Integration

Mu exposes a Model Context Protocol (MCP) server at /mcp so AI agents and tools (e.g. Claude Desktop, Cursor, or any MCP-compatible client) can connect directly.

{
  "mcpServers": {
    "mu": {
      "url": "https://mu.xyz/mcp"
    }
  }
}

See MCP Server docs for available tools and usage.

Screenshots

Home

image

View more

Concepts

The app contains cards displayed on the home screen. These are a summary or overview. Each card links to a feature page or external website. For example the Video card links to the /video page with videos by channel and search.

Hosting

Mu is free to browse. See mu.xyz. Create an account and start using it immediately.

Self Hosting

Ensure you have Go installed

Set your Go bin

export PATH=$HOME/go/bin:$PATH

Download and install Mu

git clone https://github.com/micro/mu
cd mu && go install

Configuration

To reconfigure prompts, topics, cards, etc you can adjust the following json files.

Note: The binary will need to be recompiled as they are embedded at build time.

Chat Prompts

Set the chat prompts in chat/prompts.json

Home Cards

Set the home cards in home/cards.json

News Feed

Set the RSS news feeds in news/feeds.json

Places

Set the saved search categories in places/locations.json.

When GOOGLE_API_KEY is set, Places uses the Google Places API (New) for richer results. Without it, Places falls back to free OpenStreetMap data.

export GOOGLE_API_KEY=xxx

Video Channels

Set the YouTube video channels in video/channels.json

API Keys

We need API keys for the following

Video Search

export YOUTUBE_API_KEY=xxx

Chat Model

Mu uses Anthropic Claude for all AI features:

export ANTHROPIC_API_KEY=xxx
export ANTHROPIC_MODEL=claude-sonnet-4-20250514  # Optional, this is the default

Data Storage

By default, Mu stores the search index in JSON files loaded into memory. For production use, enable SQLite with FTS5 full-text search:

export MU_USE_SQLITE=1

This stores the search index in SQLite (~/.mu/data/index.db) with FTS5 for fast full-text search. Migration from JSON happens automatically on first startup.

Run

Then run the app

mu --serve

Go to localhost:8081

Documentation

On the web: mu.xyz/docs | mu.xyz/about

Full documentation is available in the docs folder and at /docs on any Mu instance:

Getting Started

  • About - What Mu is and why it exists
  • Principles - Guiding principles for AI and technology
  • Installation - Self-hosting and deployment guide

Features

Development

Git Hooks

Install git hooks to run tests before commits:

./scripts/install-hooks.sh

This will prevent commits if tests fail, helping catch regressions early. See scripts/README.md for more details.

Payments

Mu uses Stripe for card payments. Top up with a credit or debit card and pay-as-you-go with credits. 1 credit = 1p.

See Wallet & Credits for details.

License

Mu is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).

This means you are free to use, modify, and distribute this software, but if you run a modified version on a server and let others interact with it, you must make your modified source code available under the same license.

About

The Micro Network - No ads, algorithms, or tracking.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors