{"id":28857295,"url":"https://github.com/micro/mu","last_synced_at":"2026-04-02T22:01:45.569Z","repository":{"id":325147734,"uuid":"1090889382","full_name":"micro/mu","owner":"micro","description":"The Micro Network - apps without ads, algorithms, or tracking.","archived":false,"fork":false,"pushed_at":"2026-03-26T20:44:59.000Z","size":22573,"stargazers_count":86,"open_issues_count":17,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-27T06:50:48.031Z","etag":null,"topics":["apps","mcp","micro","mu"],"latest_commit_sha":null,"homepage":"https://mu.xyz","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/micro.png","metadata":{"files":{"readme":"README.md","changelog":"news/digest/digest.go","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"asim"}},"created_at":"2025-11-06T09:21:18.000Z","updated_at":"2026-03-26T20:45:05.000Z","dependencies_parsed_at":null,"dependency_job_id":"702a672f-c647-4b99-983b-269c1778cebc","html_url":"https://github.com/micro/mu","commit_stats":null,"previous_names":["asim/mu","micro/mu"],"tags_count":23,"template":false,"template_full_name":null,"purl":"pkg:github/micro/mu","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/micro%2Fmu","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/micro%2Fmu/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/micro%2Fmu/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/micro%2Fmu/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/micro","download_url":"https://codeload.github.com/micro/mu/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/micro%2Fmu/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31317831,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T21:35:00.834Z","status":"ssl_error","status_checked_at":"2026-04-02T21:34:59.806Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apps","mcp","micro","mu"],"created_at":"2025-06-20T01:30:48.547Z","updated_at":"2026-04-02T22:01:45.563Z","avatar_url":"https://github.com/micro.png","language":"Go","readme":"# mu\n\nThe Micro Network — apps without ads, algorithms, or tracking.\n\n## Overview\n\nMu 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.\n\nBrowsing is free. Searching, posting, and AI features use credits. You get 20 free credits per day, then pay as you go from 1p.\n\n### Services\n\n- **Agent** — AI assistant that can search, answer, and build across every service\n- **Apps** — Build and use small, useful tools — or ask the agent to build one\n- **Blog** — Microblogging with daily AI-generated digests\n- **Chat** — AI-powered conversation on any topic\n- **Mail** — Private messaging and email\n- **Markets** — Live crypto, futures, and commodity prices\n- **News** — Headlines and articles from RSS feeds, chronological, with AI summaries\n- **Video** — YouTube without ads, algorithms, or shorts\n- **Wallet** — Pay as you go — 1 credit = 1p\n- **Web** — Search the web without tracking\n\nMu runs as a single Go binary on your own server or use the hosted version at [mu.xyz](https://mu.xyz).\n\n## Roadmap\n\n- [x] API - Basic API\n- [x] App - Basic PWA\n- [x] Home - Overview\n- [x] Agent - AI assistant\n- [x] Blog - Daily digests\n- [x] Chat - Discussion rooms\n- [x] News - RSS news feed\n- [x] Video - YouTube search\n- [x] Mail - Private messaging\n- [x] Markets - Live prices\n- [x] Web - Web search, no Ads\n- [x] Wallet - Card \u0026 crypto payments\n- [x] Apps - Build and launch small web apps\n- [ ] Services - Marketplace, etc\n\n### AI Features\n\n- **Blog** — Daily digests generated from trending news\n- **News** — AI summaries of articles\n- **Chat** — AI-powered conversation on any topic\n- **Agent** — Searches news, markets, video and more to answer your questions\n- **Apps** — Describe what you need, the agent builds it. \"Build me a unit converter\" → working app in seconds\n\n### MCP — AI Agent Integration\n\nMu exposes a [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server at `/mcp` so AI agents and tools (e.g. Claude Desktop, Cursor, or any MCP-compatible client) can connect directly.\n\n```json\n{\n  \"mcpServers\": {\n    \"mu\": {\n      \"url\": \"https://mu.xyz/mcp\"\n    }\n  }\n}\n```\n\nSee [MCP Server docs](docs/MCP.md) for available tools and usage.\n\n### For AI Agents\n\nMu is an API for the real world that AI agents can pay for on the fly. 30+ tools — news, search, weather, places, video, email, markets — accessible via MCP with per-request crypto payments through the [x402 protocol](https://x402.org).\n\n**No API keys. No accounts. Just call and pay.**\n\nAn autonomous agent can search the web ($0.05), check the weather ($0.01), look up nearby restaurants ($0.05), and send an email ($0.04) — paying for each request with USDC from its own wallet. Zero onboarding friction.\n\n```bash\n# Call any tool — if payment is required, the server returns 402 with pricing\ncurl -X POST https://mu.xyz/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -H \"X-PAYMENT: \u003cpayment-payload\u003e\" \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"web_search\",\"arguments\":{\"query\":\"...\"}}}'\n```\n\nSee [MCP Server docs](docs/MCP.md) for the full x402 payment flow and tool list.\n\n## Screenshots\n\n### Home\n\n\u003cimg width=\"3728\" height=\"1765\" alt=\"image\" src=\"https://github.com/user-attachments/assets/75e029f8-5802-49aa-9449-4902be5da805\" /\u003e\n\n[View more](docs/SCREENSHOTS.md)\n\n## Concepts\n\nThe 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.\n\n## Hosting\n\n**Mu is free to browse**. See [mu.xyz](https://mu.xyz). Create an account and start using it immediately.\n\n### Self Hosting\n\nEnsure you have [Go](https://go.dev/doc/install) installed\n\nSet your Go bin\n```\nexport PATH=$HOME/go/bin:$PATH\n```\n\nDownload and install Mu\n\n```\ngit clone https://github.com/micro/mu\ncd mu \u0026\u0026 go install\n```\n\n### Configuration\n\nTo reconfigure prompts, topics, cards, etc you can adjust the following json files. \n\nNote: The binary will need to be recompiled as they are embedded at build time.\n\n#### Chat Prompts\n\nSet the chat prompts in chat/prompts.json\n\n#### Home Cards\n\nSet the home cards in home/cards.json\n\n#### News Feed\n\nSet the RSS news feeds in news/feeds.json\n\n#### Places\n\nSet the saved search categories in `places/locations.json`.\n\nWhen `GOOGLE_API_KEY` is set, Places uses the [Google Places API (New)](https://developers.google.com/maps/documentation/places/web-service/overview) for richer results. Without it, Places falls back to free OpenStreetMap data.\n\n```\nexport GOOGLE_API_KEY=xxx\n```\n\n#### Video Channels\n\nSet the YouTube video channels in video/channels.json\n\n### API Keys\n\nWe need API keys for the following\n\n#### Video Search\n\n- [Youtube Data](https://developers.google.com/youtube/v3)\n\n```\nexport YOUTUBE_API_KEY=xxx\n```\n\n#### Chat Model\n\nMu uses Anthropic Claude for all AI features:\n\n```\nexport ANTHROPIC_API_KEY=xxx\nexport ANTHROPIC_MODEL=claude-sonnet-4-20250514  # Optional, this is the default\n```\n\n### Data Storage\n\nBy default, Mu stores the search index in JSON files loaded into memory. For production use, enable SQLite with FTS5 full-text search:\n\n```\nexport MU_USE_SQLITE=1\n```\n\nThis 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.\n\n### Run\n\nThen run the app\n\n```\nmu --serve\n```\n\nGo to localhost:8081\n\n## Documentation\n\n**On the web:** [mu.xyz/docs](https://mu.xyz/docs) \n\nFull documentation is available in the [docs](docs/) folder and at `/docs` on any Mu instance:\n\n**Getting Started**\n- [About](docs/ABOUT.md) - What Mu is and why it exists\n- [Principles](docs/PRINCIPLES.md) - Guiding principles for AI and technology\n- [Installation](docs/INSTALLATION.md) - Self-hosting and deployment guide\n\n**Features**\n- [Apps](docs/APPS.md) - Build and launch small web apps\n- [ActivityPub](docs/ACTIVITYPUB.md) - Federation with Mastodon, Threads, etc.\n- [Messaging](docs/MESSAGING_SYSTEM.md) - Email and messaging setup\n- [Wallet \u0026 Credits](docs/WALLET_AND_CREDITS.md) - Credit system for metered usage\n**Reference**\n- [Configuration](docs/ENVIRONMENT_VARIABLES.md) - All environment variables\n- [API Reference](docs/API_COVERAGE.md) - REST API endpoints\n- [MCP Server](docs/MCP.md) - AI tool integration via MCP\n- [Screenshots](docs/SCREENSHOTS.md) - Application screenshots\n\n## Development \n\n### Git Hooks\n\nInstall git hooks to run tests before commits:\n\n```bash\n./scripts/install-hooks.sh\n```\n\nThis will prevent commits if tests fail, helping catch regressions early. See [scripts/README.md](scripts/README.md) for more details.\n\n## Payments\n\nMu uses Stripe for card payments and the [x402 protocol](https://x402.org) for crypto payments.\n\n- **Card** — Top up with a credit or debit card via Stripe. Pay-as-you-go with credits. 1 credit = 1p.\n- **Crypto (x402)** — External clients (AI agents, apps) can pay per-request with USDC stablecoins. No account needed.\n\nSet `X402_PAY_TO` to your wallet address to enable crypto payments. See [Wallet \u0026 Credits](docs/WALLET_AND_CREDITS.md) for details.\n\n## License\n\nMu is licensed under the [GNU Affero General Public License v3.0 (AGPL-3.0)](LICENSE).\n\nThis 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.\n","funding_links":["https://github.com/sponsors/asim"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicro%2Fmu","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmicro%2Fmu","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicro%2Fmu/lists"}