{"id":50897710,"url":"https://github.com/neul-labs/ukkin","last_synced_at":"2026-07-19T13:12:46.002Z","repository":{"id":254985976,"uuid":"837357396","full_name":"neul-labs/ukkin","owner":"neul-labs","description":"Create AI agents on your phone that automate your daily tasks.","archived":false,"fork":false,"pushed_at":"2026-07-02T11:47:23.000Z","size":656,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-07-02T13:26:12.685Z","etag":null,"topics":["ai-agents","automation","dart","flutter","generative-ai","mobile","mobile-agent","mobile-ai","neul-labs","on-device","phone-automation","webbrowser"],"latest_commit_sha":null,"homepage":"https://ukkin.neullabs.com","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/neul-labs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-08-02T19:28:29.000Z","updated_at":"2026-07-02T11:47:26.000Z","dependencies_parsed_at":null,"dependency_job_id":"6fa3d1de-1d4c-4f72-9dc0-498704a1ba5d","html_url":"https://github.com/neul-labs/ukkin","commit_stats":null,"previous_names":["terraprompt/ukkin","ukkin-ai/ukkin-flutter","neul-labs/ukkin"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/neul-labs/ukkin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/neul-labs%2Fukkin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/neul-labs%2Fukkin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/neul-labs%2Fukkin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/neul-labs%2Fukkin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/neul-labs","download_url":"https://codeload.github.com/neul-labs/ukkin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/neul-labs%2Fukkin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35653726,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-19T02:00:06.923Z","response_time":112,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","automation","dart","flutter","generative-ai","mobile","mobile-agent","mobile-ai","neul-labs","on-device","phone-automation","webbrowser"],"created_at":"2026-06-16T01:31:30.076Z","updated_at":"2026-07-19T13:12:45.974Z","avatar_url":"https://github.com/neul-labs.png","language":"Dart","funding_links":[],"categories":["ai-agents"],"sub_categories":[],"readme":"# Ukkin\n\n**Create AI agents on your phone that automate your daily tasks.**\n\n**[Website](https://ukkin.neullabs.com)** · **[Documentation](https://docs.neullabs.com/ukkin)** · **[GitHub](https://github.com/neul-labs/ukkin)** · **[Neul Labs](https://www.neullabs.com)**\n\nYour phone is always on, always with you. Ukkin lets you build personal AI agents that work in the background - checking prices, monitoring social media, triaging emails, or running any workflow you describe in plain English. Ukkin is an open-source Flutter app from [Neul Labs](https://www.neullabs.com).\n\n## Why Ukkin?\n\nExisting mobile automation stacks either lock you into a vendor (Apple\nShortcuts, Google Assistant routines) or refuse to actually take action\n(\"AI concierge\" apps that only summarise). Ukkin exists for the third\ncategory: agents that do the task and show you what they did.\n\nUpstream pain points that motivated this:\n- Apple [Shortcuts #3800](https://github.com/shortcuts/all-shortcuts-site/issues) — vendor lock-in, no cross-app data flow without manual plumbing\n- Google [Assistant routines #2210](https://issuetracker.google.com/issues/2210) — closed model, no on-device LLM, no agentic tool use\n- IFTTT / Zapier mobile — requires a cloud round trip and a paid plan per active workflow\n\n| Capability | Ukkin | Apple Shortcuts | Google Assistant | IFTTT | Zapier |\n|---|---|---|---|---|---|\n| On-device execution | ✅ | ✅ | ❌ | ❌ | ❌ |\n| Natural-language agent build | ✅ | ❌ | ❌ | ❌ | ❌ |\n| Cross-app data flow | ✅ | ⚠️ manual | ❌ | ⚠️ web-only | ⚠️ web-only |\n| No subscription required | ✅ | ✅ | ✅ | ❌ | ❌ |\n| Open source | ✅ | ❌ | ❌ | ❌ | ❌ |\n| Works offline | ✅ | ✅ | ⚠️ partial | ❌ | ❌ |\n\n## The Idea\n\nTell Ukkin what you want automated:\n\n\u003e \"Watch for price drops on items in my Amazon wishlist and notify me\"\n\n\u003e \"Every morning, summarize my unread emails and flag anything urgent\"\n\n\u003e \"Monitor my Instagram mentions and draft responses for review\"\n\nUkkin converts your description into a working agent that runs on your device, respecting battery life and network conditions.\n\n## Key Features\n\n**Conversational Agent Builder**\nDescribe what you want in natural language. Ukkin extracts the workflow, shows you the steps, and creates the agent.\n\n**Device-Aware Scheduling**\nAgents run when conditions are right - on WiFi, while charging, at specific times, or when the app you need is available.\n\n**Deep App Integration**\nAutomate across WhatsApp, Email, Instagram, Amazon, Calendar, and more. Agents can read screens, tap buttons, and move data between apps.\n\n**On-Device Processing**\nAll AI runs locally. Your data never leaves your phone.\n\n## Agent Types\n\n- **Social Media**: Monitor mentions, auto-engage, track followers\n- **Communication**: Email triage, message drafting, contact management\n- **Shopping**: Price watching, deal alerts, wishlist monitoring\n- **Custom**: Build anything from a conversation\n\n## Getting Started\n\n```bash\ngit clone https://github.com/neul-labs/ukkin.git\ncd ukkin\nflutter pub get\nflutter run\n```\n\nRequires Flutter 3.1.5+, Android API 21+ or iOS 11+.\n\n## Architecture\n\nUkkin uses [AgentLib](../agentlib/), a standalone SDK for mobile AI agents. The core abstractions:\n\n- `RepetitiveTaskAgent`: Background tasks that run on schedule\n- `TaskScheduler`: Coordinates agents based on device state\n- `AppPluginSystem`: Modular integrations for each app\n- `RealAutomation`: Accessibility service bridge for screen interaction\n\n## Current Status\n\n**Working:**\n- Android Accessibility Service for screen automation\n- Real screen reading and element finding\n- Tap, type, scroll, swipe operations\n- App launching and navigation\n- Price extraction and tracking with history\n- Instagram post/follower monitoring\n- Email classification and organization\n\n**Requires:**\n- Accessibility service enabled in Android Settings\n- Target apps installed on device\n\n## Roadmap\n\n### Phase 1: Core Automation (Current)\n- Screen scraping via accessibility service\n- Basic agents: Instagram, Email, Price watching\n- Local storage for tracking data\n\n### Phase 2: Intelligence\n- On-device LLM for natural language understanding\n- Smarter element matching using context\n- Agent composition (chain multiple agents)\n\n### Phase 3: Advanced Agents\n- Calendar integration and scheduling\n- Cross-app workflows (e.g., email → calendar → reminder)\n- Voice-triggered agent creation\n- Notification-based triggers\n\n### Phase 4: Platform Expansion\n- iOS automation support\n- Desktop companion app\n- Agent marketplace/sharing\n\n## Contributing\n\nThis is an experimental project exploring on-device AI agents. Contributions welcome for:\n- New agent implementations\n- App handler improvements\n- Accessibility service enhancements\n- iOS support\n\n## License\n\nMIT\n\n---\n\n## Part of the Neul Labs toolchain\n\nUkkin is part of the OpenClaw cluster at [Neul Labs](https://www.neullabs.com):\n\n| Project | Description |\n|---------|-------------|\n| [openclaw-rs](https://github.com/neul-labs/openclaw-rs) | A community Rust implementation of OpenClaw. |\n| [openclawMU](https://github.com/neul-labs/openclawMU) | Multi-tenant fork of OpenClaw with strict data isolation. |\n| [openclawOS](https://github.com/neul-labs/openclawOS) | OS-like architecture for self-hosted AI assistants. |\n\nExplore all projects at [neullabs.com](https://www.neullabs.com).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fneul-labs%2Fukkin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fneul-labs%2Fukkin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fneul-labs%2Fukkin/lists"}