Skip to content

asim/mu

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

mu

The Micro Network

Overview

Mu is a personal app platform that provides essential online services without ads, algorithms, or tracking.

It includes:

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

Motivation

Big tech failed us. They now fuel addictive behaviour to drive profit above all else. The tools no longer work for us, instead we work for them. Let's rebuild these services without ads, algorithms or exploits for a better way of life.

Features

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

Hosted Version

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.

Concepts

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.

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/asim/mu
cd mu && go install

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

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

LLM Model

Usage requires

  • Fanar - for llm queries
  • Ollama - TODO
export FANAR_API_KEY=xxx

For vector search see this doc

Run

Then run the app

mu --serve

Go to localhost:8081

Documentation

Additional documentation is available in the docs folder:

Screenshots

Home

image

Chat

Screenshot 2025-11-30 08 07 04

News

Screenshot 2025-11-30 08 07 09

Posts

Screenshot 2025-11-30 08 07 15

Video

Screenshot 2025-11-30 08 07 57

Account

Screenshot 2025-11-30 08 08 04