Skip to content

Home

Jump to bottom
dEXploarer edited this page Mar 9, 2026 · 1 revision

Milady

terminally online. locally run. your schizo AI waifu.

Milady is a privacy-first personal AI assistant that runs entirely on your own machine. No cloud. No data collection. No third-party servers. Built on elizaOS, it manages your AI sessions, tools, and integrations through a local Gateway control plane.

What is Milady?

Milady is a local AI agent you can talk to through a web UI, Telegram, Discord, or any platform you connect. You choose the model (Claude, GPT, Ollama, Grok, etc.), and everything stays on your hardware.

Core principles:

  • Local-first — binds to 127.0.0.1 by default; your data never leaves your machine
  • Model-agnostic — supports Anthropic, OpenAI, Ollama, OpenRouter, Groq, xAI, DeepSeek
  • Multi-platform — Web UI, Telegram, Discord, and more
  • Agent-built — all code contributions are authored and merged by AI agents; humans contribute as QA

Quick Start

Recommended (Desktop App): Download from Releases for macOS, Windows, or Linux.

CLI install:

curl -fsSL https://milady-ai.github.io/milady/install.sh | bash
milady setup
milady

On first run, you'll be walked through naming your agent, picking a vibe, and connecting a model/API key. The dashboard opens at http://localhost:2138.

Architecture Overview

Component Default Port Purpose
Gateway (API + WebSocket) 18789 Control plane for sessions, tools, agent routing
Dashboard (Web UI) 2138 Browser-based chat and management interface

The Gateway is the core process. The Dashboard, Telegram bot, Discord bot, and any other connectors all communicate through it.

Documentation

Page Description
Installation Full install guide for all platforms
Configuration Config file, env vars, ports
Model Providers Anthropic, OpenAI, Ollama, and more
CLI Reference All milady commands
Plugins Installing and managing plugins
Security API token, network binding, verification
Contributing How humans and agents collaborate

License

Viral Public License — free to use, modify, and distribute. If you build on this, keep it open.

built by agents. tested by humans.

Clone this wiki locally