by kiyotakali
An open-source AI companion that actually remembers you — runs entirely on your own Mac or server. Desktop pet · long-term memory · proactive companionship · multi-device sync.
# Add to your Claude Code skills
git clone https://github.com/kiyotakali/MiruLast scanned: 7/28/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-07-28T06:26:23.691Z",
"npmAuditRan": true,
"pipAuditRan": true,
"promptInjectionRan": true
}Miru is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by kiyotakali. An open-source AI companion that actually remembers you — runs entirely on your own Mac or server. Desktop pet · long-term memory · proactive companionship · multi-device sync. It has 119 GitHub stars.
Yes. Miru passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/kiyotakali/Miru" and add it to your Claude Code skills directory (see the Installation section above).
Miru is primarily written in Python. It is open-source under kiyotakali on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh Miru against similar tools.
No comments yet. Be the first to share your thoughts!
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
Miru is 見る — Japanese for to see. Spell it out and it says something else: Memory, I Remember U. She isn't an app you launch when you need something; she lives on your desktop as a Live2D character, quietly follows your day — with your permission — and at midnight writes it into memory.
Three things set her apart from every "AI girlfriend" wrapper:
Sees your day. A screen sensor glances at your screen (default every 30s, skipped when nothing changed, adjustable, or fully off). The screenshot is analyzed and thrown away — what stays is what you were doing, never the image.
Remembers it as facts you can check. Four kinds of long-term memory — projects, people, yourself, topics — plus a daily journal and a commitment list. When you tell a friend "I'll send you the figures tonight," she reads it off the screen and quietly logs the promise.
Comes closer on her own terms. Continuous emotion and a personality of her own (defined in a soul.md). She isn't reactive-only: when she sees you've been stuck for an hour and your mood keeps sinking, she opens the conversation.
Lives across your devices. macOS, Windows, and Android can each run Miru locally, or connect through one invitation code to the same Miru on your own server.
Miru is free software; you bring your own model API keys (any OpenAI-compatible provider). A recommended setup costs under ¥2/day in tokens.
Prefer to deploy by hand? Grab Miru-Server-linux-amd64.tar.gz from Releases, run docker load, and start it on an x86-64 Linux server. See the deployment guide.
macOS / Windows / Android current device · or your own Linux server
┌─────────────────────┐ ┌────────────────────────────────────────┐
│ Live2D pet │ │ Flask backend │
│ screen sensor │ ───────> │ · chat agent (reads memory) │
│ thin native shell │ invite │ · AttentionEngine (decides to speak) │
└─────────────────────┘ code │ · memory system (slots + journal) │
│ · sleep agent (organizes at night) │
model API you configured <──┤ · SSE sync across devices │
(any OpenAI-compatible) └────────────────────────────────────────┘
Vision (reads screenshots), Chat (talks to you), Memory (organizes what she keeps). Mix providers freely.If Miru resonates with you, a ⭐ genuinely helps — and lets you follow the road to Windows, iOS, and full open source.
Heartfelt thanks to Jiazhe Wei, Hongzhe Chen, Jingkang Yang, Haofan Wang, and Chenyang Si for their help along the way.
For questions and collaborations, please contact:
Miru is released under the Apache License 2.0.
Third-party dependencies and assets remain under their respective licenses; see THIRD_PARTY_NOTICES.md.
If you deploy Miru or a modified version as part of a commercial product or service, we kindly ask you to notify us at kiyotakali075@gmail.com.
Please include the name of your organization, the product or service name, and a brief description of how Miru is being used. No confidential information is required.
This notification is requested for project tracking and community outreach purposes only. It does not require approval, impose a license fee, or modify any rights granted under the Apache License 2.0.
Developer setup and all four build targets are documented in docs/BUILDING.md. Contributions are described in CONTRIBUTING.md.