cute agents for the acceleration
Milaidy is a _personal AI assistant_ you run on your own devices, built on ElizaOS.
The Gateway is the control plane that manages sessions, tools, and events. It connects to messaging platforms, companion apps, and a WebChat UI.
If you want a personal, single-user assistant that feels local, fast, and always-on, this is it.
Download the latest DMG from GitHub Releases:
| Platform | Download |
|---|---|
| macOS (Apple Silicon) | Milaidy-arm64.dmg |
| macOS (Intel) | Milaidy-x64.dmg |
| Windows | Milaidy-Setup.exe |
| Linux | Milaidy.AppImage / .deb |
The macOS app is signed and notarized — no Gatekeeper warnings on a fresh install.
Every release includes a SHA256SUMS.txt file. After downloading, verify integrity:
``bash`macOS / Linux
cd ~/Downloads
curl -fsSLO https://github.com/milady-ai/milaidy/releases/latest/download/SHA256SUMS.txt
shasum -a 256 --check --ignore-missing SHA256SUMS.txt
`powershell`Windows (PowerShell)
cd ~\Downloads
Invoke-WebRequest -Uri "https://github.com/milady-ai/milaidy/releases/latest/download/SHA256SUMS.txt" -OutFile SHA256SUMS.txtCompare manually:
Get-FileHash .\Milaidy-Setup.exe -Algorithm SHA256
Get-Content .\SHA256SUMS.txt
Get an agent running in seconds. No config files needed.
`bash`
npx milaidy
That's it. On first run, Milaidy walks you through:
1. Pick a name for your agent (or use a random one)
2. Choose a personality style
3. Connect a model provider (or skip to configure later)
The agent starts immediately after onboarding. The web dashboard opens at http://localhost:18789.
Runtime: Node >= 22. Works with npm or bun.
macOS / Linux / WSL:
`bash`
curl -fsSL https://milady-ai.github.io/milaidy/install.sh | bash
Windows (PowerShell):
`powershell`
irm https://milady-ai.github.io/milaidy/install.ps1 | iex
The installer checks for Node.js, installs it if needed, then installs milaidy globally and runs initial setup.
`bash`
npm install -g milaidy
Then start the agent:
`bash`
milaidy start
Run directly without installing globally:
`bash`
npx milaidy
Or with bun:
`bash`
bunx milaidy
`bash`
milaidy start # Start the agent runtime (default command)
milaidy setup # Initialize workspace and config
milaidy dashboard # Open the Control UI in your browser
milaidy configure # Configuration guidance
milaidy config get
milaidy models # Show configured model providers
milaidy plugins list # List available plugins
milaidy --help # Show all commands
Upgrading? Run milaidy setup after updating to refresh the workspace.
Pick any AI provider during onboarding, or configure later.
Cloud providers:
| Provider | Env Variable | Notes |
|---|---|---|
| Anthropic (Claude) | ANTHROPIC_API_KEY | Recommended — Opus 4.5 for long-context |OPENAI_API_KEY
| OpenAI (GPT) | | GPT-4o, o1, etc. |OPENROUTER_API_KEY
| OpenRouter | | Access to 100+ models |GOOGLE_API_KEY
| Google Gemini | | Gemini Pro/Ultra |XAI_API_KEY
| xAI (Grok) | | Grok-2 |GROQ_API_KEY
| Groq | | Fast inference |DEEPSEEK_API_KEY
| DeepSeek | | DeepSeek-V3 |
Local (free, no API key):
| Provider | Setup |
|---|---|
| Ollama | Install Ollama, then select it during onboarding |
Recommended: Anthropic Pro/Max (100/200) + Opus 4.5 for long-context strength and better prompt-injection resistance.
Milaidy has first-class EVM and Solana wallet support. Wallets are generated automatically and managed through the config.
On first run, Milaidy can generate fresh EVM (Ethereum/Base/Arbitrum/Optimism/Polygon) and Solana keypairs. Private keys are stored locally in your config — never sent anywhere.
Set your own keys in ~/.milaidy/milaidy.json or via environment variables:
`bashEVM (Ethereum, Base, Arbitrum, etc.)
export EVM_PRIVATE_KEY="0x..."
$3
To view token balances and NFTs in the dashboard, configure API keys:
`bash
EVM chains (Alchemy)
export ALCHEMY_API_KEY="..."Solana (Helius)
export HELIUS_API_KEY="..."
`Or set them in the dashboard under the Wallet/Inventory tab.
$3
- EVM: Ethereum, Base, Arbitrum, Optimism, Polygon
- Solana: Mainnet (SPL tokens + NFTs via Helius DAS)
Configuration
Config file:
~/.milaidy/milaidy.jsonMinimal example:
`json5
{
agent: {
model: "anthropic/claude-opus-4-5",
},
}
`Environment variables can also be set in
~/.milaidy/.env or in the env section of the config:`json5
{
env: {
ANTHROPIC_API_KEY: "sk-ant-...",
},
}
`Agent workspace + skills
- Workspace root:
~/.milaidy/workspace (configurable via agents.defaults.workspace).
- Injected prompt files: AGENTS.md, TOOLS.md, IDENTITY.md, USER.md.
- Skills: ~/.milaidy/workspace/skills/.Security model
- Default: tools run on the host for the main session, so the agent has full access when it's just you.
- Group/channel safety: set
agents.defaults.sandbox.mode: "non-main" to run non-main sessions inside per-session Docker sandboxes.Chat commands
-
/status — session status (model + tokens, cost)
- /new or /reset — reset the session
- /compact — compact session context (summary)
- /think — off|minimal|low|medium|high|xhigh
- /verbose on|off
- /usage off|tokens|full — per-response usage footer
- /restart — restart the gatewayFrom source (development)
Prefer
pnpm for builds from source. Bun is optional for running TypeScript directly.`bash
git clone https://github.com/milady-ai/milaidy.git
cd milaidypnpm install
pnpm ui:build # auto-installs UI deps on first run
pnpm build
pnpm milaidy start
Dev loop (auto-reload on TS changes)
pnpm dev
`pnpm milaidy ... runs TypeScript directly (via tsx). pnpm build produces dist/ for running via Node / the packaged milaidy binary.$3
`bash
pnpm build:desktop
`$3
Release builds are automated via GitHub Actions. See
.github/workflows/release.yml.Required repository secrets for signed macOS builds:
-
CSC_LINK — base64-encoded .p12 signing certificate
- CSC_KEY_PASSWORD — certificate password
- APPLE_ID — Apple Developer account email
- APPLE_APP_SPECIFIC_PASSWORD — app-specific password from appleid.apple.com
- APPLE_TEAM_ID` — Apple Developer Team IDMIT