LibreAI / AI Agents / AppAgent
// agents · TencentQQGYLab/AppAgent

AppAgent

AppAgent — Tencent's multimodal agent that learns smartphone apps by exploration, then operates them.

★ 6.9k stars⑂ 759 forksMITupdated 2025-03
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

AppAgent is an open-source ai agents project by TencentQQGYLab (TencentQQGYLab/AppAgent on GitHub). It has 6,900 GitHub stars and 759 forks, is released under the MIT license, and was last updated on GitHub on 19 March 2025.

GitHub stars
6,900
Forks
759
License
MIT
Last updated on GitHub
19 March 2025
Category
AI Agents
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify your goal

    Prepare an Android device the agent can control, the target app, and your multimodal model credentials; richer app documentation leads to higher task success, per the project's tips.

  2. Get the project

    Clone TencentQQGYLab/AppAgent from GitHub (or use the install path in the run steps below) and skim its README for the parts relevant to your goal.

  3. Install and configure

    Clone the repo and install its requirements, then configure the agent with your model settings and device connection.

  4. Run your first task

    Run the exploration phase on one app so AppAgent builds its documentation, inspect that documentation for accuracy, then give it a deployment task.

// features

Why people love it

Exploration phase

The agent explores an app — autonomously or guided by your demonstrations — and generates documentation of what the app can do.

Deployment phase

With the learned documentation, the agent then executes user tasks inside the app.

Multimodal, GPT-4V-driven

Built on LLM-based multimodal perception, reading screens as a smartphone user would.

Documentation improves success

The project's own guidance: the more extensive and accurate the app documentation, the higher the task-completion likelihood — and you can inspect and correct it.

Demonstration option

You can demonstrate app functions yourself to teach the agent, instead of relying only on autonomous exploration.

Evaluated research system

Ships with the paper's evaluation setup and results, as a CHI 2025 system.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Get the source from the official GitHub repository for AppAgent.

    git clone https://github.com/TencentQQGYLab/AppAgent.git
    cd AppAgent
  2. Install requirements

    Install the Python requirements after cloning, as the repo's quick start prerequisites describe.

    pip install -r requirements.txt  # see README quick start prerequisites
  3. Explore, then deploy

    Configure the agent, run exploration on your target app to build its documentation, then run a deployment task.

    # Follow README steps 2-4: configure the agent, run the exploration phase, then the deployment phase
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains AppAgent?

TencentQQGYLab (Tencent), through the TencentQQGYLab/AppAgent repository, with the project page at appagent-official.github.io.

Is AppAgent free to use?

Yes — the project is open source under the MIT license as recorded for this listing. You can use, modify and distribute it under the MIT terms.

Does AppAgent need a paid API key?

It is driven by GPT-4V-class multimodal models, so you need your own model API access and pay for that usage; the framework code is free under MIT.

How does AppAgent compare to Mobilerun-style mobile agents?

Both drive phones from language. AppAgent's distinctive bet is its two-phase design — explore and document an app first, then deploy — from a CHI research system, whereas general mobile-agent frameworks focus on ready-to-use CLI/API operation across apps.

How do I get started with AppAgent?

Clone the repository (or use the documented installer), follow the install and configure steps on this page, and run the smallest real task first — run the exploration phase on one app so AppAgent builds its documentation, inspect that documentation for accuracy, then give it a deployment task.

// keep exploring

Similar tools

Agents

ruler

Write coding-agent rules once, then apply them to every AI coding tool you use.

★ 2.9k starsMIT
View guide →
AI Agents

morphik-core

An open-source multimodal retrieval engine for agent pipelines.

★ 3.7k starsNOASSERTION
View guide →
AI Agents

agent-desktop

Reliable computer use for any agent: drive real apps through accessibility trees, not pixel guessing.

★ 1.8k starsApache-2.0
View guide →
AI Agents

gini-agent

Gini: a personal agent runtime that remembers, learns skills, and reaches you with the right control in time.

★ 1.9k starsMIT
View guide →
AI Agents

agent-native

A framework for building agentic apps

★ 7.0k starsUnknown
View guide →
Agents

redamon

Self-hosted AI pentesting agent that finds flaws and opens PRs to fix them.

★ 2.9k starsMIT
View guide →
// alternatives

Alternatives in AI Agents

The most-starred other AI Agents projects in the LibreAI catalogue — the realistic shortlist if AppAgent is not the right fit.

Get AppAgent

Free and open — grab the source, star the repo, and start creating.