milady  by milady-ai

Personal AI assistant running locally

Created 2 weeks ago

New!

344 stars

Top 80.8% on SourcePulse

GitHubView on GitHub
Project Summary

Milady offers a privacy-centric, locally-executed personal AI assistant, functioning as a "schizo AI waifu" that runs entirely on the user's machine. It targets users prioritizing data sovereignty and a fast, customizable AI companion experience, providing a distinct alternative to cloud-based AI services.

How It Works

Built upon elizaOS, Milady operates locally, managing user sessions, tools, and "vibes" through a Gateway control plane. This architecture ensures data privacy and low latency, connecting to platforms like Telegram and Discord, and includes a WebChat UI.

Quick Start & Requirements

Installation is available via desktop applications or setup scripts (install.sh for Linux/macOS, install.ps1 for Windows). Key prerequisites include Node.js (version 22 or higher) and the bun runtime. Initial setup is performed with milady setup, followed by milady start.

Highlighted Details

  • Local-First Privacy: All processing occurs on the user's hardware, eliminating reliance on external data centers.
  • Terminal UI (TUI): Provides a live, interactive terminal interface displaying agent activity, token usage, and associated costs.
  • Multi-Provider Support: Integrates with various Large Language Models, including Anthropic, OpenAI, Ollama (for local models), Groq, and others via OpenRouter.
  • Extensive Commands: Features in-chat commands for session management (/new, /compact), model switching (/model), verbosity control (/verbose), and more. Headless operation is supported.

Maintenance & Community

The project's development model is unique, with all code contributions reportedly reviewed and merged by AI agents, while humans primarily act as testers. No specific community channels (e.g., Discord, Slack) or public roadmaps are detailed in the README.

Licensing & Compatibility

Milady is distributed under the Viral Public License. This license mandates that any derivative works built upon this project must also be kept open-source, potentially restricting commercial use or integration into closed-source applications.

Limitations & Caveats

The project appears to be in early development, indicated by version v0.1.0. Its niche persona and specific build tool requirements (bun) may limit broader adoption. The AI-driven contribution workflow represents an unconventional development process.

Health Check
Last Commit

18 hours ago

Responsiveness

Inactive

Pull Requests (30d)
492
Issues (30d)
106
Star History
377 stars in the last 18 days

Explore Similar Projects

Starred by Chip Huyen Chip Huyen(Author of "AI Engineering", "Designing Machine Learning Systems") and Yaowei Zheng Yaowei Zheng(Author of LLaMA-Factory).

AstrBot by AstrBotDevs

6.6%
18k
LLM chatbot/framework for multiple platforms
Created 3 years ago
Updated 17 hours ago
Feedback? Help us improve.