Life-Agent-RU-YEE  by ru-yee

AI agent framework for autonomous life management

Created 3 weeks ago

New!

714 stars

Top 47.9% on SourcePulse

GitHubView on GitHub
Project Summary

Life Agent RU YEE (LARY) is an AI-driven framework for autonomous life management. It targets users seeking automated daily routines, handling tasks like meal planning, grocery shopping, and household automation through a multi-agent system and natural language interaction. The core benefit is offloading routine management to an intelligent, adaptable agent.

How It Works

LARY employs a pluggable, multi-agent architecture orchestrated by a FastAPI backend. Core components include an intent router, agent communication module, and a plugin registry for agents, memory, and extensions. It leverages SSE for real-time frontend updates on tool execution and agent states. A key differentiator is its direct Android device automation via uiautomator2, enabling programmatic interaction with apps like Hema for automated grocery purchasing, bridging AI planning with real-world actions.

Quick Start & Requirements

Prerequisites include Python 3.11+, Node.js 18+, PostgreSQL 16, and Redis 7. Installation involves cloning the repository, configuring LLM API keys in .env (Volcengine, OpenAI, Anthropic, or Ollama fallback), and starting infrastructure via docker compose up -d postgres redis. The backend is launched with pip install -e ".[dev]" && python main.py, and the frontend with cd web && npm install && npm run dev. A Docker one-click deployment is available via docker compose up --build -d. Development mode offers volume mounting and USB passthrough.

Highlighted Details

  • Multi-Agent Collaboration: Dedicated agents for meal planning and purchasing autonomously coordinate tasks from recipe selection to adding items to a shopping cart.
  • Pluggable Architecture: Agents, memory modules, and extensions are designed as hot-loadable plugins, supporting community development and customization.
  • Real-time SSE: Server-Sent Events provide live streaming of tool call progress, agent thinking states, and operational logs to the user interface.
  • Android Automation: Integrates uiautomator2 for direct control of Android devices, automating interactions within specific applications for tasks like online shopping.
  • User Profiling: Dynamically builds user profiles based on household size and dietary preferences to personalize recommendations.
  • SkillHub: An upcoming marketplace for discovering, installing, and managing community-developed plugins.

Maintenance & Community

The README does not detail specific contributors, sponsorships, or community channels like Discord/Slack. The project structure and use of modern development tools (FastAPI, Vue 3, Ruff, pytest) suggest active development.

Licensing & Compatibility

The project is released under the MIT license. This permissive license allows for broad compatibility, including commercial use and integration into closed-source applications without significant restrictions.

Limitations & Caveats

The SkillHub plugin marketplace is explicitly stated as "not yet open." The Android device automation feature requires specific setup, including USB debugging or network configuration, and is primarily demonstrated with the Hema app. Core functionality relies on configured LLM API keys, with a fallback to local Ollama models.

Health Check
Last Commit

2 weeks ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
0
Star History
832 stars in the last 27 days

Explore Similar Projects

Starred by Andrew Ng Andrew Ng(Founder of DeepLearning.AI; Cofounder of Coursera; Professor at Stanford), Jack Lukic Jack Lukic(Author of Semantic UI), and
5 more.

ag2 by ag2ai

0.6%
4k
AgentOS for building AI agents and facilitating multi-agent cooperation
Created 1 year ago
Updated 1 day ago
Starred by Elie Bursztein Elie Bursztein(Cybersecurity Lead at Google DeepMind), Chip Huyen Chip Huyen(Author of "AI Engineering", "Designing Machine Learning Systems"), and
7 more.

SuperAGI by TransformerOptimus

0.1%
17k
Open-source framework for autonomous AI agent development
Created 2 years ago
Updated 1 year ago
Starred by Lilian Weng Lilian Weng(Cofounder of Thinking Machines Lab), Chip Huyen Chip Huyen(Author of "AI Engineering", "Designing Machine Learning Systems"), and
59 more.

AutoGPT by Significant-Gravitas

0.1%
183k
AI agent platform for building, deploying, and running autonomous workflows
Created 3 years ago
Updated 23 hours ago
Feedback? Help us improve.