Skip to content
Projects

AidenAI-IO/aico-link has 77 GitHub stars and 8 forks. GitHot measured +2 stars in 24 hours. Last checked 2026-11-17 00:31 UTC. Last push 2026-11-12.

How these counts are measured

77 stars8 Forks +2 in 24h

Measured star growth

in 24h
+2
in 7 days
Collecting history
in 15 days
Collecting history
in 1 month
Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

AI Agent hardware for mobile phone

AI

README.md

Original

Aico Link Firmware

Website: aico.link | Docs: Documentation Hub | Community: Join the Discord

Aico Link is the hardware. Aico is the AI Agent that runs on it. This repository provides Aico Link firmware, hardware services, and the Aico runtime. The board observes a target device through HDMI capture and controls it through USB HID, so Aico can operate normal mobile or desktop apps without relying on app-specific automation APIs.

This repository contains the firmware overlay, C++ hardware services, the Go Agent, OTA tooling, tests, and benchmark support.

Aico Link

A legacy self-assembled hardware setup is no longer maintained; the last firmware commit that supports it is ad07c4d363f2948048415ed3af0b5e4da86bcac0.

What Aico Does

Aico Link connects to a phone or computer over USB-C:

  • the target device's display output is captured over HDMI through an HDMI-to-CSI bridge;
  • the board exposes a composite USB gadget with keyboard, pointer/touch, auxiliary control HID, and USB ECM networking;
  • the Go Agent sends screenshots to a configured multimodal model, decides the next action, and writes keyboard, pointer/touch, and Android extension or Consumer Control reports to /dev/hidg0, /dev/hidg1, and /dev/hidg2;
  • voice mode records audio on the board, applies VAD, then uses configured STT, LLM, and TTS providers.

The basic control path does not require jailbreak, ADB, developer mode, or a custom app on the target device. It does require a target that can output video to the capture path and accept USB HID input. iOS control also requires AssistiveTouch to be enabled.

Key Features

1. True Portability

Most mobile agent projects are lab prototypes that require a laptop or desktop to run. Aico Link is:

  • Pocket-sized — Powered entirely by your phone's USB-C port (future versions will be credit-card-sized and magnetically attach to phone backs)
  • Plug-and-play core control — HDMI observation and USB HID control work without pairing or a companion app. Optional Phone Bridge, BLE Wake, and notification features require the companion app and their documented setup.
  • Production-ready — Designed for daily use, not just research prototypes

2. Fully Open

  • Open-source firmware — Complete C++ services and Go agent code
  • Flexible model backends — Configure registered providers such as OpenAI, OpenRouter, Kimi, Volcengine, DeepSeek, or Ollama; use OpenRouter for Anthropic Claude and Google Gemini models
  • Exportable data — Your memory, skills, and learned behaviors are yours to keep and migrate
  • Community-driven — Contributions welcome; flash custom firmware freely

3. Privacy-First

  • No Aico backend — All services (LLM, STT, TTS) are user-configured external endpoints
  • Zero data collection — We never see your screen, conversations, or behavior
  • Self-hostable — Run your own models; keep everything on your infrastructure
  • Auditable — Open-source code under community scrutiny

4. Adaptive Intelligence

  • Persistent memory — Aico remembers device-specific context, user preferences, and past interactions
  • Self-improving skills — Skills update based on usage patterns and new workflows
  • Personalized over time — The more you use Aico, the better it understands your habits and needs

5. Real-Time Voice Interaction

  • Hardware VAD (Voice Activity Detection) — Wake-word-free voice control with sub-100ms latency
  • Streaming STT/TTS — Natural conversation flow with live transcription and speech synthesis
  • Audio feedback — Aico speaks responses and status updates

Repository Scope

  • Firmware integration: Debian rootfs overlay and business package, systemd services, USB gadget setup, Wi-Fi/config portal defaults, and full update.img generation.
  • C++ services: frame_service owns HDMI capture and exposes screenshots over Unix domain sockets; audio_service owns recording/playback and volume state.
  • Go Agent: the device-side LLM runtime, voice loop, skills, memory, and built-in screenshot/HID/audio/shell tools.
  • USB networking: The board exposes usb0 at 192.168.42.1 for the device config page and local board-to-phone communication.
  • OTA: A/B partition updates, signed manifests, health confirmation, and abctl diagnostics.

The firmware has no required Aico-hosted backend. Screenshots, audio, and text are sent only to the model/STT/TTS/search endpoints you configure.

Architecture

Target display
    -> HDMI / HDMI-to-CSI bridge / CSI
    -> /dev/video0
    -> frame_service
    -> screenshot tool
    -> Go Agent
    -> HID tools
    -> /dev/hidg0, /dev/hidg1, and /dev/hidg2
    -> target device input

Board audio
    -> audio_service
    -> VAD / STT or audio attachment
    -> Go Agent / LLM
    -> TTS
    -> audio_service playback

At runtime, the Agent is intentionally decoupled from C++ service internals: Frame and Audio capabilities go through Unix domain sockets, while device control goes through the Linux USB gadget HID device nodes.

Quick Start

For the fastest hardware-free experience, start Config Web and Agent Web with the Try Aico on PC guide:

docker compose up --build

Open http://localhost:8000 for Config Web and http://localhost:8080 for Agent Web. The sandbox can also connect to MobileGym, an ADB target, or another compatible environment bridge. For benchmark suites and reports, see Benchmark.

First-time hardware users should start with Newcomer Quickstart. It walks through flashing, Wi-Fi setup, Agent configuration, voice verification, and troubleshooting; its wiring steps apply only to the legacy self-assembled board.

Clone the repository (the BSP is included in pico-sdk/; --recursive also initializes the MobileGym dependency):

git clone --recursive [email protected]:AidenAI-IO/aico-link.git aico-link-firmware
cd aico-link-firmware

Build and audit the Debian ARM application bundle:

scripts/debian-apps/build-apps.sh all

Build the full firmware image:

./debian_build.sh

Flash a prebuilt or locally built update.img on Linux. The guarded helper checks the digest and requires an explicit confirmation because a factory flash overwrites userdata:

FLASH_TOOL=pico-sdk/tools/linux/Linux_Upgrade_Tool/upgrade_tool
IMAGE=output/debian/image/update.img
SHA256=$(awk '{print $1}' "${IMAGE}.sha256")
scripts/flash.sh inspect --tool "${FLASH_TOOL}"
sudo scripts/flash.sh flash \
  --tool "${FLASH_TOOL}" \
  --image "${IMAGE}" \
  --sha256 "${SHA256}" \
  --confirm-erase-all-data

The repository-root upgrade_tool/upgrade_tool is a macOS Mach-O binary and is not executable on Linux. For a locally built image, the Linux tool path and image path above are the usual defaults. On macOS, use the repository-root tool directly:

./upgrade_tool/upgrade_tool uf ./output/debian/image/update.img

Documentation

The full documentation is organized under docs/:

Contributing

Contributions are welcome for firmware, services, Agent runtime, skills, tests, benchmarks, and documentation. Before contributing, read LICENSE; it defines the dual-license terms, contribution license grant, patent terms, and hardware-design licensing notes for this repository.

Do not commit secrets, device-specific credentials, or local environment files.

License

This repository is distributed under the dual-license terms described in LICENSE, with the AGPL-3.0 text included in LICENSE-AGPL-3.0. Third-party components keep their own licenses; see NOTICE for details.