Skip to content

micro/mu

Repository files navigation

mu

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

Overview

Mu is a collection of apps for everyday use. While other platforms monetize your attention with ads and infinite feeds, Mu gives you simple utilities that respect your time.

The problem: The internet is designed to waste your time. Feeds are infinite, videos autoplay, and everything tracks you.

The solution: Small, focused tools that do one thing well. No ads. No algorithms. No tracking.

Featured Apps

  • Home - Your personalized dashboard
  • Blog - Blogging with daily digests
  • Chat - Discuss topics with AI
  • News - RSS feeds with AI summaries
  • Mail - Private messaging & email
  • Video - Watch YouTube without ads
  • Web - Search without ads or tracking
  • Wallet - Credits and card payments

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
  • Blog - Daily digests
  • Chat - Discussion rooms
  • News - RSS news feed
  • Video - YouTube search
  • Mail - Private messaging
  • Web - Web search, no Ads
  • Wallet - Card payments
  • Services - Marketplace, etc

AI Features

Some features are enhanced with AI:

  • Blog - Daily digests
  • News - Summarize articles
  • Chat - Knowledge assistant
  • Agent - Cross app queries

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

Contributing

Join Discord if you'd like to work on this.

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.

Sponsorship

You can sponsor the project using GitHub Sponsors to support development and hosting costs. Sponsors get early access to new features and can vote on the project roadmap. All features remain free (with daily limits) or pay-as-you-go.

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

One app for everything you need

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors