The Micro Network
Mu is a personal app platform that provides essential online services without ads, algorithms, or tracking.
It includes:
- Home - One place to catchup with everything
- Chat - AI assistant with contextual discussions
- News - Curated RSS feeds and market data
- Posts - Microblogging and community sharing
- Video - YouTube search and Ad-free viewing
- App - A progressive web app for mobile
- API - REST API for programmatic access
Mu runs as a single Go binary on your own server or use the hosted version at mu.xyz.
Technology should empower people, not exploit them. Mu is built on the principle of servitude. Tools that serve humanity with humility, respect privacy, and enable meaningful connection without addiction, surveillance, or manipulation.
Starting with:
- API - Basic API
- App - Basic PWA
- Home - Overview
- Chat - LLM chat UI
- News - RSS news feed
- Video - YouTube search
- Posts - Micro blogging
Coming soon:
- Mail - Private inbox
- Wallet - Credits for usage
- Utilities - QR code scanner, etc
- Services - Marketplace of services
Basic concepts. The app contains cards displayed on the home screen. These are a sort of summary or overview. Each card links to a micro app or an external website. For example the latest Video "more" links to the /video page with videos by channel and search, whereas the markets card redirects to an external app.
There are built in cards and then the idea would be that you could develop or include additional cards or micro apps through configuration or via some basic gist like code editor. Essentially creating a marketplace.
Mu is free to use at mu.xyz. Create an account and start using it immediately - no credit card required.
Optional membership is available to support ongoing development and hosting costs. Members get early access to new features and a voice in the project's direction. This is entirely optional - the platform remains free for all users.
Ensure you have Go installed
Set your Go bin
export PATH=$HOME/go/bin:$PATH
Download and install Mu
git clone https://github.com/asim/mu
cd mu && go install
Set the chat prompts in chat/prompts.json
Set the home cards in home/cards.json
Set the RSS news feeds in news/feeds.json
Set the YouTube video channels in video/channels.json
We need API keys for the following
export YOUTUBE_API_KEY=xxx
Ollama (Default)
By default, Mu uses Ollama for LLM queries. Install and run Ollama locally:
# Install Ollama from https://ollama.ai/
# Pull a model (e.g., llama3.2)
ollama pull llama3.2
# Ollama runs on http://localhost:11434 by default
Optional environment variables:
export MODEL_NAME=llama3.2 # Default model
export MODEL_API_URL=http://localhost:11434 # Ollama API URL
Fanar (Optional)
Alternatively, use Fanar by setting the API key:
export FANAR_API_KEY=xxx
export FANAR_API_URL=https://api.fanar.qa # Optional, this is the default
When FANAR_API_KEY is set, Mu will use Fanar instead of Ollama.
For vector search see this doc
Then run the app
mu --serve
Go to localhost:8081
Additional documentation is available in the docs folder:
- Design Documentation - Architecture and design decisions
- Vector Search - Setting up vector embeddings for semantic search
- Contextual Discussions - Chat context and discussion features
- Screenshots - Application screenshots
Join Discord if you'd like to work on this. Read the code of ethics issue first.
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.