GitHub Kotlin Weekly Trending

HapeLee/legado-with-MD3

使用 Material Design 3 全新设计的阅读 3.0

Legado with MD3

简体中文｜ English

📖 介绍

Legado with MD3 是基于开源项目阅读 (Legado) 开发的 Material Design 3 风格重构版本。

本项目在对 UI 进行重绘的基础上，加入了多项分支独有功能，并正在逐步从传统 View 迁移至 Jetpack Compose 框架，目标是提供更加现代、流畅且一致的阅读体验。

Caution

注意事项： 由于使用 Monet 引擎重构了主题系统，官方版本的主题在此版本中不再可用。

Android 12 以下设备： 暂时无法使用自定义主题与动态取色功能。此限制将在 Jetpack Compose 迁移完成后得到解决（由于开发者精力有限，迁移过程将持续较长时间）。

✨ 分支特性

相比于官方版本，本项目具有以下独有特性：

全新主题： 全新 Material Design 3 设计界面，支持 预测性返回手势 与 共享元素动画。
阅读界面： 更加个性化的阅读界面与菜单配置。
阅读记录： 提供详尽的阅读记录，支持 时间轴 与 章节维度 统计。
体验增强： 更健全的 漫画阅读 、 有声书 与发现等界面体验。
书架布局： 更多的书架布局选择，针对 平板端 进行了专门的界面优化。
实用功能： 新增书籍备注、智能伴生分组（自动归类已读/未读），支持手柄上下翻页。

🛠️ 核心功能

多格式支持： 支持本地 TXT、EPUB 阅读，智能扫描本地文件。
高度自定义： 切换字体、背景、行距、段距、加粗、简繁转换等。
净化替换： 强力去除广告，替换正文内容。
翻页模式： 覆盖、仿真、滑动、滚动等多种模式随心切换。
完全开源： 无广告，持续迭代优化。

❤️ 致谢

感谢以下优秀开源项目提供的灵感与技术支持：

gedoor/legado (这个项目最吊的老爹)
Luoyacheng/legado (提供了更多的扩展功能)
komikku-app/komikku (提供了界面灵感与一些 Compose 的优秀控件)
FoedusProgramme/Gramophone (提供了界面灵感与 View 系统的封面取色方法)
jordond/MaterialKolor (基于 Jetpack Compose 优秀的取色实现)
Calvin-LL/Reorderable (基于 Jetpack Compose 优秀的拖动排序实现)
以及更多开源项目...

⚠️ 免责声明

项目内容不代表原作者立场，与原项目作者不存在任何隶属或授权关系。

SukiSU-Ultra/SukiSU-Ultra

Kernel-based Android Root Solution & KPM

SukiSU Ultra

English | 简体中文 | 日本語 | Türkçe | Русский

A kernel-based root solution for Android devices, forked from tiann/KernelSU, and added some interesting changes.

Features

Kernel-based su and root access management
App Profile: Lock up the root power in a cage
Support non-GKI and GKI 1.0
KPM Support
Tweaks to the manager theme and the built-in susfs management tool.

Compatibility Status

KernelSU (before v1.0.0) officially supports Android GKI 2.0 devices (kernel 5.10+).
Older kernels (4.4+) are also compatible, but the kernel will have to be built manually.
With more backports, KernelSU can supports 3.x kernel (3.4-3.18).
Currently, only arm64-v8a, armeabi-v7a (bare) and X86_64(some) are supported.

Installation

See guide/installation.md

Integration

See guide/how-to-integrate.md

Translation

If you need to submit a translation for the manager, please go to Crowdin.

KPM Support

Based on KernelPatch, we removed features redundant with KSU and retained only KPM support.
Work in Progress: Expanding APatch compatibility by integrating additional functions to ensure compatibility across different implementations.

Open-source repository: https://github.com/ShirkNeko/SukiSU_KernelPatch_patch

KPM template: https://github.com/udochina/KPM-Build-Anywhere

Note

Requires CONFIG_KPM=y
Non-GKI devices requires CONFIG_KALLSYMS=y and CONFIG_KALLSYMS_ALL=y
For kernels below 4.19, backporting from set_memory.h from 4.19 is required.

Troubleshooting

Device stuck upon manager app uninstallation? Uninstall com.sony.playmemories.mobile

Sponsor

ShirkNeko (maintainer of SukiSU)
weishu (author of KernelSU)

ShirkNeko's sponsorship list

Ktouls Thanks so much for bringing me support.
zaoqi123 Thanks for the milk tea.
wswzgdg Many thanks for supporting this project.
yspbwx2010 Many thanks.
DARKWWEE 100 USDT
Saksham Singla Provide and maintain the website
OukaroMF Donation of website domain name

License

The file in the “kernel” directory is under GPL-2.0-only license.
The images of the files ic_launcher(?!.*alt.*).* with anime character sticker are copyrighted by 怡子曰曰, the Brand Intellectual Property in the images is owned by 明风 OuO, and the vectorization is done by @MiRinChan. Before using these files, in addition to complying with Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International, you also need to comply with the authorization of the two authors to use these artistic contents.
Except for the files or directories mentioned above, all other parts are under GPL-3.0 or later license.

Credit

KernelSU: upstream
MKSU: Magic Mount
RKSU: support non-GKI
susfs: An addon root hiding kernel patches and userspace module for KernelSU.
KernelPatch: KernelPatch is a key part of the APatch implementation of the kernel module

KernelSU's credit

Kernel-Assisted Superuser: The KernelSU idea.
Magisk: The powerful root tool.
genuine: APK v2 signature validation.
Diamorphine: Some rootkit skills.

koiverse/ArchiveTune

The Cutest Material 3 Expressive Music Player With Support Local File and Youtube Music for Android.

ArchiveTune

Redefining the YouTube Music Experience on Android.
It’s high-performance, privacy-focused, and packed with features for people who really care about their experience.

Official Website • Features • Privacy • Download • Screenshots • Support

ArchiveTune isn’t just another generic YouTube Music wrapper. It’s a fully custom-built player made from the ground up, because we think your music should stay private, look clean, and work exactly the way you expect. If you care about sound quality and want something that actually feels good to use, this is it.

Important

Geographic Availability: If YouTube Music is not supported in your region, a VPN or proxy set to a supported region is required for initial data fetching.

📸 Showcase

✨ Features

Playback Multiple account support with quick switching Ad-free playback with background listening Your playlists, liked songs, and subscriptions appear after sign-in Support local file and local song playback Fast startup and lightweight performance Built for a private, uninterrupted listening experience	Audio EBU R128 loudness normalization Tempo, pitch, and playback speed controls Crossfade between tracks System equalizer and spatial audio integration
Lyrics & Discovery Live synced lyrics Lyrics translation, AI Lyrics translation and romanization Music recognition for songs around you Listening statistics whenever you want them	Sync & Social Import playlist from spotify YouTube Music account integration Last.fm scrobbling ListenBrainz history sync Discord rich presence support
Interface Material 3 design language Album-art powered dynamic colors Up to 9 different player styles Up to 8 different player background styles Responsive layouts for different screen sizes Clean browsing, player, artist, album, and lyrics views	Customization Deep playback and interface settings Dynamic color theming options Gesture customization Animation and layout tuning Flexible controls to shape the app around your workflow

📥 Download Now

Stable Release

Obtainium	IzzyOnDroid

GitHub

OpenAPK	Unclouded

Nightly Build

GitHub Actions

Warning

Notes: The trusted download source is listed above; we are not responsible for any risks you may encounter from downloading from other sources.

❓ Need Help or Have Questions?

Join Our Telegram Channels or Discord Servers for Support and Discussion.

🌍 Globalization

ArchiveTune belongs to everyone. Help us localize the experience for your region.

✨ Project Contributors

🛠️ Development & Engineering

Interested in building the project or contributing? ArchiveTune is built on a high-performance Kotlin stack. Read the Build & Contribution Guide →

🤝 Acknowledgments

We stand on the shoulders of open-source giants:

Metrolist by Mostafa Alagamy For Base framework.
SimpMusic by maxrave-dev For Lyrics API Provider.
BetterLyrics For word-by-word Lyrics API Provider & Artwork Provider.
Material Color Utilities
Read You and Seal for Ui Components.
The global community of translators and beta testers.

⚖️ Legal Disclaimer

ArchiveTune is an independent third-party client.

Not affiliated with Google LLC or YouTube.
Does not bypass YouTube's technical protections.
Users are encouraged to support artists by purchasing music via official channels.

If ArchiveTune elevated your music experience, please consider giving us a ⭐

2dust/v2rayNG

A V2Ray client for Android, support Xray core and v2fly core

v2rayNG

A V2Ray client for Android, support Xray core and v2fly core

Telegram Channel

github_2dust

Usage

Geoip and Geosite

geoip.dat and geosite.dat files are in Android/data/com.v2ray.ang/files/assets (path may differ on some Android device)
download feature will get enhanced version in this repo (Note it need a working proxy)
latest official domain list and ip list can be imported manually
possible to use third party dat file in the same folder, like h2y

Development guide

Android project under V2rayNG folder can be compiled directly in Android Studio, or using Gradle wrapper. But the v2ray core inside the aar is (probably) outdated.
The aar can be compiled from the Golang project AndroidLibV2rayLite or AndroidLibXrayLite. For a quick start, read guide for Go Mobile and Makefiles for Go Developers

v2rayNG can run on Android Emulators. For WSA, VPN permission need to be granted via appops set [package name] ACTIVATE_VPN allow

wxxsfxyzm/InstallerX-Revived

More Expressive InstallerX !

InstallerX Revived (Community Edition)

English | 简体中文 | Español | 日本語 | Deutsch

A modern and functional Android app installer. (You know some birds are not meant to be caged, their feathers are just too bright.)

Looking for a better app installer? Try InstallerX!

InstallerX Revived is a modern Android package installer and the community-maintained continuation of the original InstallerX project.

It is designed to replace limited stock or OEM package installers with a cleaner interface, broader package support, configurable installation profiles, and privileged workflows through Shizuku, Root, Dhizuku, or the system package manager mode.

Documentation

The full user guide, installation instructions, advanced options, system integration notes, and FAQ are maintained on the documentation site.

Highlights

Package formats: APK, APKS, APKM, XAPK, APK files inside ZIP archives, and batch APK installation.
Install flows: dialog installation, background notification installation, automatic installation, silent installation when privileges allow it, and Android 16+ Live Activity progress on supported systems.
Authorizers:
- Root: can perform all privileged operations, but may be slower because of cold app_process startup.
- Shizuku: obtains shell or root capabilities depending on how it is activated, and is usually faster than direct Root.
- Dhizuku: can perform DevicePolicyManager-based operations such as default installer locking and app installation, but is limited for other privileged tasks.
- None: is fully limited by the system, but can silently install when InstallerX is running as the system package installer.
Profiles: define how installation and uninstallation requests are handled, including install mode, authorizer override, installer/requester metadata, target user, DexOpt, auto-delete behavior, split selection, blacklist policy, and signature gates.
System integration: InstallerX can be locked as the default installer from the Home page status card, used with LSPosed modules such as InxLocker, or installed as a replacement system package manager by advanced users.
Modern UI: Material 3 Expressive and Miuix interface styles, dark mode, dynamic color, advanced palettes, system icon packs, colorful dialogs, standard notifications, Live Activity, and Xiaomi HyperOS-style island notifications on supported Xiaomi devices.
Safety controls: package-name and SharedUID blacklists, signature mismatch and unknown-signature policy gates, permission preview, install flags, and one-time smart suggestions for selected blocked cases.

Supported Android Versions

Full support: Android SDK 34 - 37.0
Limited support: Android SDK 26 - 33

Limited support means InstallerX may work, but some features can be unavailable or behave differently because of Android framework, OEM, or authorizer limitations.

Downloads

Stable releases: https://github.com/wxxsfxyzm/InstallerX-Revived/releases/latest
Alpha builds: https://github.com/wxxsfxyzm/InstallerX/releases
CI builds: https://github.com/wxxsfxyzm/InstallerX-Revived/actions/workflows/auto-preview-dev.yml
Telegram channel: https://t.me/installerx_revived

When reporting bugs, please reproduce them on the latest Alpha or CI build whenever possible, because issues in Stable may already be fixed.

InstallerX is published in two variants:

Online: supports direct APK download links and online update features. Network permission is only used for installation-related features.
Offline: requests no network permission. Online-only features will show a clear error instead.

Both variants share the same package name, version code, and signature, so they replace each other instead of installing side by side.

Building

InstallerX Revived is an Android Gradle project.

Prerequisites

JDK 25 with JAVA_HOME configured correctly.
Android SDK / Android Studio with the required platform and build tools installed.
GitHub Packages credentials for the snapshot miuix dependency.

GitHub Packages Authentication

GitHub Packages requires authentication even for public packages. Add your GitHub username and a classic personal access token with the read:packages scope to your global Gradle properties file:

Linux / macOS: ~/.gradle/gradle.properties
Windows: %USERPROFILE%\.gradle\gradle.properties

gpr.user=YOUR_GITHUB_USERNAME
gpr.key=YOUR_PERSONAL_ACCESS_TOKEN

Do not commit these credentials to this repository.

Build Commands

For a local debug build:

./gradlew assembleOnlineUnstableDebug assembleOfflineUnstableDebug

For a PR-style test build with a separate application id:

./gradlew assembleOnlinePreviewDebug assembleOfflinePreviewDebug -PAPP_ID="com.rosan.installer.x.revived.test"

Common Questions

Where should I report bugs or ask questions?

Use GitHub Issues for reproducible bugs and concrete feature requests. Good suggestions are welcome. Use GitHub Discussions or the Telegram channel for general questions and compatibility discussion.

Before opening an issue, please read CONTRIBUTING.md for the required logs and reproduction details.

I cannot lock InstallerX as the default installer

Some OEM systems strictly control the default package installer. Open the default installer page from the Home page status card and try locking from there. If the ROM still prevents it, use an LSPosed module such as InxLocker.

HyperOS says installing system apps requires a valid installer

This is an OEM security restriction. InstallerX can declare installer metadata through profiles, and on HyperOS it uses com.android.shell as the default compatibility installer package. Shizuku or Root is required for this workflow; Dhizuku is not enough.

Notification installation progress is stuck

Some ROMs restrict background services aggressively. Set InstallerX to unrestricted background/battery mode if notification installation stalls. InstallerX cleans up its foreground service shortly after the installation task finishes.

How do I replace the system package manager?

This is a high-risk advanced workflow. The short version is: use Core Patch to overwrite the APK, flash a matching module, or integrate the matching package into super / a ROM build. Before flashing or packaging, verify the package name, mount path, and permissions file for your ROM.

See the system integration guide for details: https://wxxsfxyzm.github.io/InstallerX-Revived-Website/guide/system-integration

Localization

Help translate InstallerX Revived on Weblate:

https://hosted.weblate.org/engage/installerx-revived/

License

InstallerX Revived is released under the GNU General Public License v3.

If you base your work on InstallerX Revived, you must comply with the open-source license terms of the specific source version you use.

Acknowledgements

This project uses code from, or is based on the implementation of, the following projects:

Star History

AAswordman/Operit

The most powerful AI agent and AI chat software on Android/Operit是一款Android上能力最为强大、发展最久的AI Agent

中文 | English

Operit AI - 智能助手应用

📱 移动端首个功能完备的AI智能助手应用，完全独立运行，拥有强大的工具调用能力 📱

🌟 项目简介

Operit AI 是移动端首个功能完备的 AI 智能助手应用，完全独立运行于您的 Android 设备上（除API调用），拥有强大的工具调用能力、深度搜索、工作流与自动化、智能记忆库，并支持人设定制与角色卡等高度自定义功能，集成 MNN/llama.cpp 本地模型、MCP/Skill 生态与多语言界面。它不仅仅是聊天界面，更是与Android权限和各种工具深度融合的全能助手，内置Ubuntu 24 环境，提供前所未有的强大功能。

⚡ 核心亮点

🖥️ Ubuntu 24 环境

内置完整 Ubuntu 24 系统，支持 vim、MCP、Python等工具，在手机上运行复杂的Linux命令和自动化任务

🧠 智能记忆系统

AI自动分类管理记忆，支持时间查询/导入导出/自动总结，智能搜索历史对话，记住您的偏好和习惯，提供个性化服务

🗣️ 语音交互

连续自然对话，支持本地/云端 TTS + 本地 STT、自定义音色、语音/特定音频唤醒、自动朗读

🤖 本地AI模型

支持 MNN / llama.cpp 本地模型（GGUF），完全离线运行AI，保护隐私数据

🎭 人设与角色卡

自定义AI性格、说话风格，支持角色卡导入导出（酒馆/JSON）/备份/二维码分享，角色卡可互聊并拥有独立对话历史

🔌 丰富工具生态

40+ 内置工具 + MCP/Skill 市场插件 + 工具包/工作流，含自动点击 Agent、绘图/图片搜索、AI 互聊/自我认知、定时任务、提示词市场等，覆盖文件操作、网络请求、系统控制、媒体处理

🛠️ 功能速览

📦 内置工具系统（点击展开）

工具类型	功能说明
🐧 Linux环境	完整Ubuntu 24，支持apt包管理、Python/Node.js运行环境、自定义软件源
📁 文件系统	读写文件、搜索、解压缩、格式转换、Git集成
🌐 网络工具	HTTP请求、网页访问、文件上传下载、Web开发与导出
⚙️ 系统操作	安装应用、权限管理、无障碍 / ADB / Root 三通道自动化（含 AutoGLM 自动点击 Agent，支持 adb root 虚拟屏/多显示器）
🎬 媒体处理	视频转换、帧提取、OCR/图像理解、相机拍照、音视频读取
🧑‍💻 开发与终端	Web 工作区/一键打包、代码编辑/语法高亮、终端 SSH/Chroot/vim、Ctrl 组合键
🎨 AI 创作	绘图工具包（OpenAI/Qwen/NanoBanana）、图片搜索/下载
🔍 搜索引擎	深度搜索、DuckDuckGo、Tavily、谷歌学术、Bing、Sogou、Quark、百度地图集成
🧩 工具包 & 工作流	工具包生态/包管理、工作流自动化、定时触发、语音唤醒触发

🎨 界面定制（点击展开）

✨ 主题系统：自定义颜色、字体、间距、内边距
🌍 多语言支持：中英覆盖，自动随系统语言切换
🔤 字体与排版：全局字体大小、聊天边距自定义
🎭 桌宠功能：WebP动画支持、自定义表情、悬浮窗显示
📱 布局优化：隐藏状态栏、自定义工具栏、平板适配
🎨 Markdown渲染：LaTeX公式（支持左右滚动）、代码高亮、表格、Mermaid图表
🧾 信息展示：思考链折叠、HTML块预览、代码/思考块高度限制
🪟 悬浮窗体验：悬浮窗/气泡模式头像隐藏、圈选识屏、全屏预览
🧮 数据统计：Token 用量统计、模型饼图

🔗 集成能力（点击展开）

🤖 Tasker集成：触发自定义AI代理事件，深度自动化
🌐 MCP/Skill 市场：一键安装插件、远程MCP、自动描述、uvx/npx支持
🔌 多模型支持：OpenAI、Claude、Gemini、百灵、OpenRouter、LMStudio
🧪 模型与提示词管理：多配置/参数自定义、提示词市场
🔐 权限系统：工具级权限控制与安全提示
🔑 密钥池与统计：批量测试/导入、Token 统计（模型饼图）
🗂️ 工作区绑定：支持 SAF / SFTP / SSH 工作区绑定与文件访问
🖱️ 自动点击 Agent：AutoGLM + UI Tree 双通道，支持自动化操作
📊 工具并行：只读工具并行执行，提升响应速度

💬 对话与记忆管理（点击展开）

🧠 记忆库：自动分类/搜索、时间查询、导入导出、附件记忆
💬 对话管理：自动总结与总结编辑、历史分组/分支/迁移、对话锁定、角色卡独立历史
⚡ 对话并行：并行对话处理、工具包 state 决策
🤖 角色互动：角色卡互聊、查看历史、思考链折叠
📦 聊天记录：多格式导入导出、历史备份与恢复

💾 数据与备份（点击展开）

🗂️ 全局/自动备份：数据库定时备份，支持损坏恢复（排除 MCP/Skill/终端/包）
🎭 角色卡：备份、导出（酒馆/JSON）、二维码分享
🧷 工作区：SAF/SFTP/SSH 绑定、代码编辑/语法高亮、Git ignore
🧰 Skill 管理：Skill 开关、仓库解析与缓存下载

📸 功能展示

Web开发
在手机上设计网页并导出为独立应用

悬浮窗 & 附件
随时调用，便捷分享

插件市场
丰富的MCP生态

🚀 快速开始

项目	说明
📋 系统要求	Android 8.0+ (API 26+)，建议 4GB+ 内存，200MB+ 存储
📥 下载安装	Release页面下载最新APK
📖 使用指南	完整文档包含详细教程和示例

安全提示： 为确保您的数据安全，请务必从官方 Release页面或官方网站下载本应用。通过未知渠道下载的安装包可能被恶意修改，从而导致隐私泄露或设备被监听。

安装步骤： 下载APK → 安装启动 → 按引导配置 → 开始使用 ✨

🔮 TODO / 开发计划

UI 自动化与截图管线
- ✅ 已支持无障碍 / ADB / Root 三种权限模式的 UI 自动化
- ✅ 支持 adb root 场景下的虚拟屏幕/多显示器（display 参数）
- ✅ UI Tree 支持 AutoGLM + 本地 uiautomator dump 双方案

📅 版本更新历程

版本	发布日期	核心更新
v1.10.1 _最新	2026-04-17	• 内置浏览器与网页自动化：大幅增强内置浏览器，支持标签页、历史、书签、权限、多窗口、最小化与视口控制，并补齐浏览器脚本的导入、安装、启停、存储与页面菜单能力 • 虚拟形象与界面定制：支持 FBX 虚拟形象并升级 MMD 预览，新增液态玻璃主题效果，并增强侧边栏、聊天气泡与输入栏的外观自定义 • 插件、工作区与上下文增强：支持通过配置编辑器调试和自动编写 Operit 插件，新增本地 HTTP 对话入口、工作区重命名与规则文件自动读取，并增强历史跳转、双向分页与上下文自动补充能力 • 稳定性与性能优化：修复工具权限、HTTP TTS、SSH/tmux 长输出、历史跳转、GIF/公式/Markdown 渲染、MCP 配置与统计等问题，并持续优化对话链路、深度搜索、记忆系统、浏览器与包管理器
v1.10.0	2026-03-18	• 角色卡群聊与 AI 自配置：支持多个角色卡群聊与 @ 交互，新增 AI 自我设置能力，可辅助配置 MCP、Skill、STT、TTS 与模型参数 • 主题与交互升级：新增分组折叠消息、气泡主题及字体/颜色/背景自定义、更宽气泡、输入框液态玻璃、长按图标直达设置/语音模式，以及助手形象与 MP4 虚拟形象支持 • 工具与平台扩展：新增 Ollama、NVIDIA、OpenAI Response 通用模式，补充独立 SSH 插件工具包、Java Bridge、APKTool 插件、Web 自动化下载、Markdown 音视频渲染、xAI 视频生成、工作流取消、终端自定义按键与消息队列 • 修复与性能优化：修复语音识别、记忆并发、悬浮窗交互、终端显示、Web 自动化全屏、MNN Tool Call 等问题，并优化记忆召回、市场搜索、工作区模板、grep 工具性能与 Agent 重试稳定性
v1.9.1	2026-02-20	• 稳定性修复：集中修复 1.9.0 多项问题，提升整体可用性与流畅性 • 终端与工具调用：增强终端工具，修复交互 UI 卡住、严格工具调用历史工具报错、Windows 控制器 raw 命令执行问题 • MCP 与记忆库：修复远程 MCP 无法关闭，重做记忆库写入逻辑，支持外接向量模型并新增连接修改工具 • 功能补充与界面修复：新增未绑定角色卡聊天记录删除、工作流批量删除与执行日志查看，修复输入法/暗色输入框/主题透明度/工具箱包管理等问题
v1.9.0	2026-02-17	• 移动端网页自动操作：新增网页操作能力，支持工作区 Web 项目 CORS 绕过访问外部网页 • Windows 终端操作：支持 Windows 命令操作，可控制 Codex 等 CLI，新增严格工具调用模式补充兼容性 • 工具与系统扩展：新增 SQL 查看器、Android 工作区模板、OpenAI response 兼容供应商、skill 直接输入添加、统计饼图 • 修复与优化：修复图片读取/上下文总结/特殊符号截断/ffmpeg 等问题，增强模型连通性测试输出与 MCP 加载提示
v1.8.1	2026-02-03	• llama.cpp 本地推理：支持 GGUF 本地模型与相关工具 • 工具与界面：图片搜索/下载、HTML 块预览、代码/思考块高度限制、气泡头像隐藏、Token 饼图、思考链折叠 • 数据与备份：全局备份（排除 MCP/skill/终端/包）+ 角色卡备份/导出/分享、Skill 开关、密钥池导入/批量测试、工作区支持 SAF 绑定 • 修复：AI 朗读回声录制、悬浮窗 Token 统计、角色编辑键盘遮挡、深搜 Token 爆炸、MCP 启动、工作流悬浮窗退出、表格截断、硅基流动语音打断
v1.8.0	2026-01-13	• 工作流系统：支持计算/传入传出/执行等能力，并支持语音唤醒触发 • 语音唤醒：直接进入语音对话模式，支持语音下关键词快速附件附着 • 对话并行：支持对话并行处理，工具包 state 机制可动态决定工具 • 新增与优化：记忆时间查询、自动备份、OpenAI 绘图/语音供应商、MCP 启动优化、终端 chroot、修复多项 BUG
v1.7.1	2025-12-31	• Root 虚拟屏幕自动化：支持 root 启动虚拟屏幕，AutoGLM 并发多窗口任务 • Skill 生态：新增 Skill 协议与 Skill 市场，并支持 BETA 计划追踪 nightly • 交互增强：总结编辑、网页访问改悬浮窗模式、圈选识屏、对话锁定 • 修复与优化：大图崩溃、ToolCall 错误、代码块换行、启动速度与虚拟屏稳定性
v1.7.0	2025-12-19	• GUI 自动化里程碑：Autoglm + 虚拟屏幕（可在设置中开关虚拟屏幕） • 自动化增强：一键 Autoglm 配置与单独执行器，虚拟屏开关逻辑与截图质量自定义 • 体验优化：密钥非聚焦显示为星号，强制不允许 Autoglm 设置为主模型 • 工具扩展：NanoBanana 绘图包、apply file 非覆盖支持、MNN STT 等
v1.6.3	2025-12-08	• 原生ToolCall支持：支持原生模型工具调用、DeepSeek思考工具 • 工作区与终端增强：新建时选择项目类型、SSH文件系统连接、终端无障碍支持 • 模型与消息显示：支持模型配置多选、消息显示模型名称与提供者 • 优化与修复：优化悬浮窗、修复终端卡顿、迁移工作区到内部存储
v1.6.2	2025-11-20	• 对话管理增强：长按开分支、历史记录分类显示、批量迁移 • 模型配置优化：配置重命名、上下文绑定、谷歌原生搜索 • Bug修复：界面切换、粗体换行、气泡模式等问题 • 增加crossref学术论文检索包、升级代码编辑器
v1.6.1	2025-11-05	• 性能大优化：重做UI绘制，大幅提升流畅性 • AI视觉增强：直接识别图片、间接识别能力 • 终端SSH：支持SSH连接和反向挂载手机文件系统 • 自动总结机制、深度搜索、新授权系统
v1.6.0	2025-10-21	• MNN本地模型支持 • 记忆库大更新：AI自动分类、智能搜索、导入导出 • 终端优化：vim支持、进度条、自定义软件源 • Tasker集成、桌宠功能、故事线标签
v1.5.2	2025-10-05	• MCP增强：uvx/npx支持、启动加速 • 工作区 Git ignore • 相机拍照、HTML渲染、正则过滤
v1.5.0	2025-09	• Ubuntu 24终端完整集成 • MCP市场上线 • 桌宠功能、深度搜索模式
v1.4.0	2025-08	• 多工具并行执行 • 人设卡系统、角色选择器 • PNG角色卡导入
v1.3.0	2025-08	• Web开发功能 • 主题选择器、自定义UI • Anthropic Claude支持
v1.2.x	2025-07	• 语音对话系统 • 知识库功能 • DragonBones动画支持
v1.1.x	2025-06	• MCP协议支持 • OCR识别、悬浮窗 • Gemini完整支持
v1.0.0	2025-05	• 首个正式版本 • 基础AI对话、工具调用 • Shizuku/Root集成

📝 完整更新日志：访问 Releases 页面查看每个版本的详细更新内容

👨‍💻 开源共创

欢迎加入 Operit 开源生态！我们欢迎各种贡献：第三方脚本、MCP插件、核心功能开发。

开发者须知：

📚 开源共创指南 | 脚本开发指南
📦 构建项目需从 Google Drive 下载依赖库压缩包（models.zip、subpack.zip、jniLibs.zip、libs.zip）
💬 加入社区讨论：QQ群 | Discord

💖 贡献者

感谢所有为 Operit AI 做出贡献的人！

💖 支持开发

如果 Operit AI 对您有帮助，欢迎自愿支持项目持续开发与基础运营：

海外支持可使用 Patreon
境内支持可使用爱发电
赞助完全自愿，不与任何功能、额度、更新、答疑或其他权益挂钩
即使不赞助，也不影响正常使用、获取更新或访问开源代码
您也可以直接使用 GitHub 仓库顶部的 Sponsor 按钮进入赞助页面

📄 许可证

本项目采用 GNU LGPLv3 许可证。

简单来说，这意味着：

您可以自由地使用、修改和分发本项目的代码。
如果您修改了代码并进行分发，您也必须以 LGPLv3 许可证开源您修改过的部分。
详细信息请参阅 LICENSE 文件。

📝 问题反馈

遇到问题或有建议？欢迎提交 Issue！

提交指南：

📝 清晰描述问题/建议，提供复现步骤
📱 附上设备型号、系统版本等信息
📸 如有可能，提供截图或录屏

⭐ 如果觉得项目不错，请给我们一个 Star ⭐

🚀 帮助我们推广，让更多人了解 Operit AI 🚀

_{Made with ❤️ by the Operit Team}

sameerasw/essentials

Essential tools and mods for Android nerds

Essentials

Essential tools, mods and workarounds for Pixels and other Androids

sameerasw.com/essentials

Featuring Essentials

Navigation

Extension

WearOS Companion app

Features

Sound and Haptics

Sound mode switcher
Ambient music glance - Media playback on AOD and screensaver
Call vibrations - For call accept, decline and ending

Security and Privacy

Screen locked security - Disable QS tiles while locked
App lock

Notifications and Alerts

Notification lighting - Edge lighting and more alerts for notifications
Flashlight pulse - Pulse flashlight for notifications
Snooze system notifications
Battery notification for all your connected devices

Input and Actions

Link actions - Intercept and share links from default apps
Button remap
Keyboard
Circle to search automations

Widgets

Screen off empty widget
Batteries

Display

Customize statusbar icons and modules
Dynamic Always on Display
Caffeinate to keep screen awake
Dynamic night light - App based night light
Scale and animation adjustments
Glove mode
Hide gesture bar

Watch

Sync all calendars to your WearOS watch periodically

Other

Maps power saving mode - For not just Pixel 10, Any Android device
Are we there yet? - Get reminded when your stop is closeby
Watermark - Add EXIF data and logos to captured photos
Flashlight enhancements - With brightness controls and global fade-in-out effect
Private DNS - Pick your custom DNS or cycle through them easily
Your Android - Everything about your device in one place
Eye dropper - Android 17 color picker

DIY

Automate things yourself and make custom triggers

App Freezing

Save power and less distractions by freezing away rarely used apps

App Updater

Check for sideloaded app updates directly from GitHub

Quick Settings Tiles

Toggle UI blur
Toggle chat bubbles
Toggle sensitive content on lock screen
Toggle tap to wake
Toggle AOD
Caffeinate controls
Charging optimization (Pixel)
Sound mode switcher
Mono audio toggle
Flashlight controls and brightness adjustment
Stay awake
NFC toggle
Adaptive brightness toggle
Private DNS toggle
USB debugging toggle
Developer options toggle
Toggle other in-app features

Requirements

Android 8.0 or higher (Feature support may vary)
App permissions are optional, Grant necessary permissions for each feature
Targetted for Google Pixel devices extending to other Androids
Tested on Google Pixel 7 (Android 17 beta program).
Some features and functionalities might not work as expected on other OEMs. (Especially NothingOS and OneUI)

Screenshots

Installation

During the installation, you probably will see a warning similar to this claiming the app blocked during installation with no way to continue at all.

This is a new restriction on Android with sideloaded apps that can receive sensitive permissions such as Accessibility or notification listener which both Essentials may utilize.

You can still proceed avoiding this but you will have to temporarily disable Google Play Protect during the installation.
But then again, you may notice the toggle for play protect in play store is enabled and grayed out not allowing to be disabled. This is due to the "Advanced protection" feature in Pixels that entirely blocks sideloading. So you will have to disable "Advanced Protection" as well.
Follow belwo steps to avoid it during the installation.

IMPORTANT: Yes, this is very annoying but I understand the need of such prevention to avoid users installing potentially harmful apps from unknown sources. Well I hope you trust me to install my app but anyways, You should always verify the trusted source before installing any APK file from the internet. ʅ(°_°)ʃ

Shell Providers (Shizuku & Root)

Essentials supports both Shizuku and Root as shell providers for executing advanced system-level commands.
Shizuku: Make sure to get the latest version of Shizuku preferably from a fork such as yangFenTuoZi/Shizuku or other not from the Google Play as it is no longer well supported especially with Android 16 QPR1 up.
Root: If your device is rooted, Essentials can bypass Shizuku and use root privileges directly for features like Button Remap and App Freezing.

How to grant accessibility permissions

Localization

Help us bring Essentials to more people around the world! If you're fluent in another language, you can contribute by translating the app on Crowdin.

Support translation on Crowdin

Contributing

We welcome contributions from the community! Whether you're fixing a bug, adding a new feature, or improving documentation, your help is appreciated.

Please read our CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Thanks

chalda-pnuzig/emojis.json - Keyboard emojis
xav-ie/generate-kaomoji - Keyboard kaomojis
TebbeUbben/ChargeQuickTile - Pixel charging QS

Stars ❤️

Last updated: 2026-04-06

OuterTune/OuterTune

A Material 3 Music Player for Android with local file & YouTube Music support. Forked from InnerTune

OuterTune

A Material 3 music player for Android

Hey there...

I won't waste your time:

This app is no longer in active development. If you are looking for a replacement YouTube Music client, try Metrolist, ArchiveTune, etc. If you are looking for a local music player (or want to keep with with my antics...), then Gramophone may just be for you.

Should anyone wish to take on the maintainer role and resurrect this app, feel free to contact us 😄

However, if you do want me to waste your time: https://github.com/OuterTune/OuterTune/discussions/1116

Click to show old readme

⠀⠀ ⠀⠀

Features

OuterTune is a supercharged fork of InnerTune. This app is both a local media player, and a YouTube Music client.

YouTube Music client features
- Song downloading (offline playback)
- Seamless playback: no ADs & background playback
- Account synchronization
  - Full playlist sync from the app to the remote account is temporally unavailable
Local audio file playback (ex. MP3, OGG, FLAC, etc.)
- Play local and Youtube Music songs at the same time
- Uses a custom tag extractor instead of MediaStore's broken metadata extractor! (e.g tags delimited with \ now show up properly)
Sleek Material3 design
Multiple queues
Synchronized lyrics, and support for word by word/Karaoke lyrics formats (e.g LRC, TTML)
Audio normalization, tempo/pitch adjustment, and various other audio effects
Android Auto support
Support for Android 8 (Oreo) and higher

Note

Android 8 (Oreo) and higher is supported. While the app may work on Android 7.x (Nougat), we do not officially support this version

Note

Read our FAQ and guides on our wiki

Screenshots

Full image gallery

Warning

If you're in a region where YouTube Music is not supported, you won't be able to use this app unless you have a proxy or VPN to connect to a YTM supported region.

Building & Contributing

We are looking for contributors, translators, and maintainers! If you would like to help out, or just wish to build the app yourself, please see the building and contribution notes.

Submitting Translations

We use Weblate to translate OuterTune. For more details or to submit translations, visit our Weblate page.

Thank you very much for helping to make OuterTune accessible to many people worldwide.

Support us

If you like OuterTune, you're welcome to send a donation. Donations will support the development, including bug fixes and new features.

Help & Support

For bug reports and/or feature requests, please create a GitHub issue. If you have want help with the app, check out the Discussion Forum.

For all other inquiries NOT related to the app, you can contact us at outertune@protonmail.com. This is NOT a support email!

Attribution

Thanks to all our contributors! Check them out here

z-huang/InnerTune for providing an awesome base for this fork, none of this would have been possible without it.

Musicolet for inspiration of a local music player experience done right.

Gramophone for emotional support, and a legendary lyrics parser

Disclaimer

This project and its contents are not affiliated with, funded, authorized, endorsed by, or in any way associated with YouTube, Google LLC or any of its affiliates and subsidiaries.

Any trademark, service mark, trade name, or other intellectual property rights used in this project are owned by the respective owners.

embabel/embabel-agent

Agent framework for the JVM. Pronounced Em-BAY-bel /ɛmˈbeɪbəl/

Embabel Agent Framework

Embabel (Em-BAY-bel) is a framework for authoring agentic flows on the JVM that seamlessly mix LLM-prompted interactions with code and domain models. Supports intelligent path finding towards goals. Written in Kotlin but offers a natural usage model from Java. From the creator of Spring.

Key Concepts

Models agentic flows in terms of:

Actions: Steps an agent takes
Goals: What an agent is trying to achieve
Conditions: Conditions to assess before executing an action or determining that a goal has been achieved. Conditions are reassessed after each action is executed.
Domain model: Objects underpinning the flow and informing Actions, Goals and Conditions.
Plan: A sequence of actions to achieve a goal. Plans are dynamically formulated by the system, not the programmer. The system replans after the completion of each action, allowing it to adapt to new information as well as observe the effects of the previous action. This is effectively an OODA loop.

Application developers don't usually have to deal with these concepts directly, as most conditions result from data flow defined in code, allowing the system to infer pre and post conditions.

These concepts underpin these differentiators versus other agent frameworks:

Sophisticated planning. Goes beyond a finite state machine or sequential execution with nesting by introducing a true planning step, using a non-LLM AI algorithm. This enables the system to perform tasks it wasn’t programmed to do by combining known steps in a novel order, as well as make decisions about parallelization and other runtime behavior.
Superior extensibility and reuse: Because of dynamic planning, adding more domain objects, actions, goals and conditions can extend the capability of the system, without editing FSM definitions or existing code.
Strong typing and the benefits of object orientation: Actions, goals and conditions are informed by a domain model, which can include behavior. Everything is strongly typed and prompts and manually authored code interact cleanly. No more magic maps. Enjoy full refactoring support.

Other benefits:

Platform abstraction: Clean separation between programming model and platform internals allows running locally while potentially offering higher QoS in production without changing application code.
Designed for LLM mixing: It is easy to build applications that mix LLMs, ensuring the most cost-effective yet capable solution. This enables the system to leverage the strengths of different models for different tasks. In particular, it facilitates the use of local models for point tasks. This can be important for cost and privacy.
Built on Spring and the JVM, making it easy to access existing enterprise functionality and capabilities. For example:
- Spring can inject and manage agents, including using Spring AOP to decorate functions.
- Robust persistence and transaction management solutions are available.
Designed for testability from the ground up. Both unit testing and agent end to end testing are easy.

Flows can be authored in one of two ways:

An annotation-based model similar to Spring MVC, with types annotated with the Spring stereotype @Agent, using @Goal, @Condition and @Action methods.
Idiomatic Kotlin DSL with agent { and action { blocks.

Either way, flows are backed by a domain model of objects that can have rich behavior.

We are working toward allowing natural language actions and goals to be deployed.

The planning step is pluggable.

The default planning approach is Goal Oriented Action Planning. GOAP is a popular AI planning algorithm used in gaming. It allows for dynamic decision-making and action selection based on the current state of the world and the goals of the agent.

Goals, actions and plans are independent of GOAP. Embabel also supports Utility AI out of the box, which can run the same actions but chooses actions based on (potentially dynamic) utility scores rather than strict preconditions and postconditions. This is valuable for exploration and open-ended tasks, when we do not need to achieve a specific goal but want to maximize overall utility.

The framework executes via an AgentPlatform implementation.

An agent platform supports the following modes of execution:

Focused, where user code requests particular functionality: User code calls a method to run a particular agent, passing in input. This is ideal for code-driven flows such as a flow invoked in response to an incoming event.
Closed, where user intent (or another incoming event) is classified to choose an agent. The platform tries to find a suitable agent among all the agents it knows about. Agent choice is dynamic, but only actions defined within the particular agent will run.
Open, where the user's intent is assessed and the platform uses all its resources to try to achieve it. The platform tries to find a suitable goal among all the goals it knows about and builds a custom agent to achieve it from the start state, including relevant actions and conditions. The platform will not proceed if it is unconvinced as to the applicability of any goal. The GoalChoiceApprover interface provides developers a way to limit goal choice further.

Open mode is the most powerful, but least deterministic.

In open mode, the platform is capable of finding novel paths that were not envisioned by developers, and even combining functionality from multiple providers.

Even in open mode, the platform will only perform individual steps that have been specified. (Of course, steps may themselves be LLM transforms, in which case the prompts are controlled by user code but the results are still non-deterministic.)

Possible future modes:

Evolving mode: Where the platform can work with multiple goals in the same process and modify a running process to add further goals and agents. For example, an action can realize that it has become important to achieve additional goals.

Embabel agent systems will also support federation, both with other Embabel systems (allowing planning to incorporate remote actions and goals) and third party agent frameworks.

Quick Start

Get an agent running in under 5 minutes.

Create your own agent repo from our Java or Kotlin GitHub template by clicking the "Use this template" button.

You'll have an agent running in under a minute if you already have an OPENAI_API_KEY and have Maven installed.

📚 For examples and tutorials, see the Embabel Agent Examples Repository

🚗 For a sophisticated, realistic example application, see the Tripper travel planner agent

AI-generated travel itinerary with detailed recommendations

Map link included in output

Why Is Embabel Needed?

TL;DR Because the evolution of agent frameworks is early and there's a lot of room for improvement; because an agent framework on the JVM will deliver great business value.

Why do we need an agent framework at all? We can write code without higher level abstractions, directly invoking LLMs and controlling flow directly in code. However, a higher level agent framework offers compelling benefits. For example:
- Breaking up LLM interactions, making them simpler and more focused. This maximizes reuse and minimizes cost and errors. It often allows us to use cheaper models for point interactions.
- Facilitating both unit and integration testing, which remain as important with agentic systems as with any other software systems.
- Increasing composability where subflows and individual actions can be reused
- Making applications more manageable and robust, enabling a workflow manager to control their execution and retry operations while maintaining previous state
- Enhancing safety through the ability to apply guardrails in many places
Why do we need an agent framework for the JVM when solutions exist in Python?: While agent frameworks initially appeared predominantly Python, it's early and there's plenty of room for novel and superior approaches. The key adjacency is not the LLM--which is a simple HTTP call away--but existing code and infrastructure assets that are more valuable on the JVM than in Python.
Why not use just Spring AI? Spring AI is great. We build on it, and embrace the Spring component model. However, we believe that most applications should work with higher level APIs. An analogy: Spring AI exists at the level of the Servlet API, while Embabel is more like Spring MVC. Complex requirements are much easier to express and test in Embabel than with direct use of Spring AI.
Why not attempt to contribute this project to Spring? This project requires different governance from Spring, where most projects exist in stable environments and dependability and stability outweighs rapid innovation. Second, the concepts are not JVM-specific. We hope that Embabel will become the leading agent framework across platforms. While the Spring brand is valuable in Java, it is not in TypeScript or Python.

Show Me The Code

In Java or Kotlin, agent implementation code is intuitive and easy to test.

Java


@Agent(description = "Find news based on a person's star sign")
public class StarNewsFinder {

    private final HoroscopeService horoscopeService;
    private final int storyCount;

    // Services are injected by Spring
    public StarNewsFinder(
            HoroscopeService horoscopeService,
            @Value("${star-news-finder.story.count:5}") int storyCount) {
        this.horoscopeService = horoscopeService;
        this.storyCount = storyCount;
    }

    @Action
    public StarPerson extractStarPerson(UserInput userInput, Ai ai) {
        return ai
                .withLlm(OpenAiModels.GPT_41)
                .createObjectIfPossible(
                        """
                                Create a person from this user input, extracting their name and star sign:
                                %s""".formatted(userInput.getContent()),
                        StarPerson.class
                );
    }

    @Action
    public Horoscope retrieveHoroscope(StarPerson starPerson) {
        return new Horoscope(horoscopeService.dailyHoroscope(starPerson.sign()));
    }

    // toolGroups specifies tools that are required for this action to run
    @Action(toolGroups = {CoreToolGroups.WEB})
    public RelevantNewsStories findNewsStories(
            StarPerson person,
            Horoscope horoscope,
            Ai ai) {
        var prompt = """
                %s is an astrology believer with the sign %s.
                Their horoscope for today is:
                    <horoscope>%s</horoscope>
                Given this, use web tools and generate search queries
                to find %d relevant news stories summarize them in a few sentences.
                Include the URL for each story.
                Do not look for another horoscope reading or return results directly about astrology;
                find stories relevant to the reading above.
                
                For example:
                - If the horoscope says that they may
                want to work on relationships, you could find news stories about
                novel gifts
                - If the horoscope says that they may want to work on their career,
                find news stories about training courses.""".formatted(
                person.name(), person.sign(), horoscope.summary(), storyCount);
        return ai
                .withDefaultLlm()
                .createObject(prompt, RelevantNewsStories.class);
    }

    // The @AchievesGoal annotation indicates that completing this action
    // achieves the given goal, so the agent can be complete
    @AchievesGoal(
            description = "Write an amusing writeup for the target person based on their horoscope and current news stories",
            export = @Export(
                    remote = true,
                    name = "starNewsWriteupJava",
                    startingInputTypes = {StarPerson.class, UserInput.class})
    )
    @Action
    public Writeup writeup(
            StarPerson person,
            RelevantNewsStories relevantNewsStories,
            Horoscope horoscope,
            Ai ai) {
        var llm = LlmOptions
                .withModel(OpenAiModels.GPT_41_MINI)
                // High temperature for creativity
                .withTemperature(0.9);

        var newsItems = relevantNewsStories.getItems().stream()
                .map(item -> "- " + item.getUrl() + ": " + item.getSummary())
                .collect(Collectors.joining("\n"));

        var prompt = """
                Take the following news stories and write up something
                amusing for the target person.
                
                Begin by summarizing their horoscope in a concise, amusing way, then
                talk about the news. End with a surprising signoff.
                
                %s is an astrology believer with the sign %s.
                Their horoscope for today is:
                    <horoscope>%s</horoscope>
                Relevant news stories are:
                %s
                
                Format it as Markdown with links.""".formatted(
                person.name(), person.sign(), horoscope.summary(), newsItems);
        return ai
                .withLlm(llm)
                .createObject(prompt, Writeup.class);
    }
}

Kotlin

@Agent(description = "Find news based on a person's star sign")
class StarNewsFinder(
    // Services such as Horoscope are injected by Spring
    private val horoscopeService: HoroscopeService,
    // Potentially externalized by Spring
    @param:Value("\${star-news-finder.story.count:5}")
    private val storyCount: Int = 5,
) {

    @Action
    fun extractPerson(
        userInput: UserInput,
        ai: Ai
    ): StarPerson =
        // All prompts are typesafe
        ai.withDefaultLlm()
            .createObject("Create a person from this user input, extracting their name and star sign: $userInput")

    // This action doesn't use an LLM
    // Embabel makes it easy to mix LLM use with regular code
    @Action
    fun retrieveHoroscope(starPerson: StarPerson) =
        Horoscope(horoscopeService.dailyHoroscope(starPerson.sign))

    // This action uses tools
    // "toolGroups" specifies tools that are required for this action to run
    @Action(toolGroups = [ToolGroup.WEB])
    fun findNewsStories(
        person: StarPerson,
        horoscope: Horoscope,
        ai: Ai,
    ): RelevantNewsStories =
        ai.withDefaultLlm().createObject(
            """
            ${person.name} is an astrology believer with the sign ${person.sign}.
            Their horoscope for today is:
                <horoscope>${horoscope.summary}</horoscope>
            Given this, use web tools and generate search queries
            to find $storyCount relevant news stories summarize them in a few sentences.
            Include the URL for each story.
            Do not look for another horoscope reading or return results directly about astrology;
            find stories relevant to the reading above.

            For example:
            - If the horoscope says that they may
            want to work on relationships, you could find news stories about
            novel gifts
            - If the horoscope says that they may want to work on their career,
            find news stories about training courses.
        """.trimIndent()
        )

    // The @AchievesGoal annotation indicates that completing this action
    // achieves the given goal, so the agent run will be complete
    @AchievesGoal(
        description = "Write an amusing writeup for the target person based on their horoscope and current news stories",
    )
    @Action
    fun writeup(
        person: StarPerson,
        relevantNewsStories: RelevantNewsStories,
        horoscope: Horoscope,
        ai: Ai,
    ): Writeup =
        ai
            .withLlm(
                LlmOptions
                    .withModel(model)
                    .withTemperature(0.9)
            )
            .createObject(
                """
            Take the following news stories and write up something
            amusing for the target person.

            Begin by summarizing their horoscope in a concise, amusing way, then
            talk about the news. End with a surprising signoff.

            ${person.name} is an astrology believer with the sign ${person.sign}.
            Their horoscope for today is:
                <horoscope>${horoscope.summary}</horoscope>
            Relevant news stories are:
            ${relevantNewsStories.items.joinToString("\n") { "- ${it.url}: ${it.summary}" }}

            Format it as Markdown with links.
        """.trimIndent()
            )

}

The following domain classes ensure type safety:

Java


@JsonClassDescription("Person with astrology details")
@JsonDeserialize(as = StarPerson.class)
public record StarPerson(
        String name,
        @JsonPropertyDescription("Star sign") String sign
) implements Person {

    @JsonCreator
    public StarPerson(
            @JsonProperty("name") String name,
            @JsonProperty("sign") String sign
    ) {
        this.name = name;
        this.sign = sign;
    }

    @Override
    public String getName() {
        return name;
    }
}

public record Horoscope(String summary) {
}

@JsonClassDescription("Writeup relating to a person's horoscope and relevant news")
public record Writeup(String text) implements HasContent {

    @JsonCreator
    public Writeup(@JsonProperty("text") String text) {
        this.text = text;
    }

    @Override
    public String getContent() {
        return text;
    }
}

Kotlin

data class RelevantNewsStories(
    val items: List<NewsStory>
)

data class NewsStory(
    val url: String,

    val summary: String,
)

data class Subject(
    val name: String,
    val sign: String,
)

data class Horoscope(
    val summary: String,
)

data class FunnyWriteup(
    override val text: String,
) : HasContent

It's easy to unit test your agents to ensure that they correctly execute logic and pass the correct prompts and hyperparameters to LLMs. For example:

public class StarNewsFinderTest {

    @Test
    void writeupPromptMustContainKeyData() {
        HoroscopeService horoscopeService = mock(HoroscopeService.class);
        StarNewsFinder starNewsFinder = new StarNewsFinder(horoscopeService, 5);
        var context = new FakeOperationContext();
        context.expectResponse(new com.embabel.example.horoscope.Writeup("Gonna be a good day"));

        NewsStory cockatoos = new NewsStory(
                "https://fake.com.au",
                "Cockatoo behavior",
                "Cockatoos are eating cabbages"
        );

        NewsStory emus = new NewsStory(
                "https://morefake.com.au",
                "Emu movements",
                "Emus are massing"
        );

        StarPerson starPerson = new StarPerson("Lynda", "Scorpio");
        RelevantNewsStories relevantNewsStories = new RelevantNewsStories(Arrays.asList(cockatoos, emus));
        Horoscope horoscope = new Horoscope("This is a good day for you");

        starNewsFinder.writeup(starPerson, relevantNewsStories, horoscope, context);

        var prompt = context.getLlmInvocations().getFirst().getPrompt();
        var toolGroups = context.getLlmInvocations().getFirst().getInteraction().getToolGroups();


        assertTrue(prompt.contains(starPerson.getName()));
        assertTrue(prompt.contains(starPerson.sign()));
        assertTrue(prompt.contains(cockatoos.getSummary()));
        assertTrue(prompt.contains(emus.getSummary()));

        assertTrue(toolGroups.isEmpty(), "The LLM should not have been given any tool groups");
    }
}

Dog Food Policy

We believe that all aspects of software development and business can and should be greatly accelerated through the use of AI agents. The ultimate decision makers remain human, but they can and should be greatly augmented.

This project practices extreme dogfooding.

Our key principles:

We will use AI agents to help every aspect of the project: coding, documentation, community management, producing marketing copy etc. Any human performing a task should ask why it cannot be automated, and strive toward maximum automation.
Developers retain ultimate control. Developers are responsible for guiding agents toward the solution and iterating as necessary. A developer who commits or merges an agent contribution is responsible for ensuring that it meets the project coding standards, which are independent of the use of agents. For example, code must be human-readable.
We will favour open source agents built on the Embabel platform, and contribute improvements. While commercial agents may be more advanced in some areas, we believe that our platform is the best general solution for automation and by dogfooding we will improve it fastest. By open sourcing agents used on our open source projects, we will maximize benefit to the community.
We will prioritize agents that help accelerate our progress. Per the flight safety advice to fit your own mask before helping others, we will prioritize agents that help us accelerate our own progress. This will not only produce useful examples, but increase overall project velocity.

Developers must carefully read all code they commit and improve generated code if possible.

Coding agents are a special case. While the embabel-agent-code submodule offers support for project modification that is useful for project bootstrapping, coding agents are the most mature of commercial agents, and their vendors are heavily subsidising their users, making it economically irrational to insist on our own platform.

Getting Started

Get the bits
Set up your environment
Run the application

Getting the bits

Choose one of the following:

Clone the repository via git clone https://github.com/embabel/embabel-agent
Create a new Spring Boot project and add the necessary dependencies (see "Using Embabel Agent Framework in Your Project" below)

Environment variables

Environment variables are consistent with common usage, rather than Spring AI. For example, we prefer OPENAI_API_KEY to SPRING_AI_OPENAI_API_KEY.

Required:

OPENAI_API_KEY: For the OpenAI API

Optional:

ANTHROPIC_API_KEY: For the Anthropic API. Necessary for the coding agent.
MINIMAX_API_KEY: For the MiniMax API. Supports MiniMax-M2.7 and MiniMax-M2.7-highspeed models.
OCI Generative AI uses OCI SDK authentication providers. Add embabel-agent-starter-oci-genai and set embabel.agent.platform.models.ocigenai.compartment-id; OCI config file, instance principal, resource principal, workload identity, session token and simple key authentication are supported.

We strongly recommend providing both an OpenAI and Anthropic key, as some examples require both. And it's important to try to find the best LLM for a given task, rather than automatically choose a familiar provider.

Services

You will need a Docker Desktop version >4.43.2. Be sure to activate the following MCP tools from the catalog:

Brave Search
Fetch
Puppeteer
Wikipedia

You can also set up your own MCP tools using Spring AI conventions. See the application-docker-desktop.yml file for an example.

If you're running Ollama locally, include the embabel ollama starter and Embabel will automatically connect to your Ollama endpoint and make all models available.


<dependency>
    <groupId>com.embabel.agent</groupId>
    <artifactId>embabel-agent-starter-ollama</artifactId>
</dependency>

Running

Create your own agent project with

uvx --from git+https://github.com/embabel/project-creator.git project-creator

Example Agents

📚 For examples and tutorials, see the Embabel Agent Examples Repository

# Clone and run examples
git clone https://github.com/embabel/embabel-agent-examples
cd embabel-agent-examples/scripts/kotlin
./shell.sh

Shell Commands

Spring Shell is an easy way to interact with the Embabel agent framework, especially during development.

Type help to see available commands. Use execute or x to run an agent:

execute "Lynda is a Scorpio, find news for her" -p -r

This will look for an agent, choose the star finder agent and run the flow. -p will log prompts -r will log LLM responses. Omit these for less verbose logging.

Options:

-p logs prompts
-r logs LLM responses

Use the chat command to enter an interactive chat with the agent. It will attempt to run the most appropriate agent for each command.

Spring Shell supports history. Type !! to repeat the last command. This will survive restarts, so is handy when iterating on an agent.

Further examples

Example commands within the shell:

# Perplexity style deep research
# Requires both OpenAI and Anthropic keys and Docker Desktop with the MCP extension (or your own web tools)
execute "research the recent australian federal election. what is the position of the greens party?"

# x is a shortcut for execute
x "fact check the following: holden cars are still made in australia; the koel is a bird native only to australia; fidel castro is justin trudeau's father"

Bringing in additional LLMs

Local models with well-known providers

The Embabel Agent Framework supports local models from:

Ollama: Simply add embabel-agent-starter-ollama starter to your pom.xml and your local Ollama endpoint will be queries. All local models will be available.
Docker: Add the embabel-agent-starter-dockermodels starter to your pom.xml and your local Docker endpoint will be queried. All local models will be available.
LMStudio: This uses the openAI compatible client. Just include LMStudio as a dependency and make sure your LMStudio server is running.

OCI Generative AI

Add embabel-agent-starter-oci-genai to use OCI Generative AI chat and embedding models.

<dependency>
    <groupId>com.embabel.agent</groupId>
    <artifactId>embabel-agent-starter-oci-genai</artifactId>
</dependency>

Configure embabel.agent.platform.models.ocigenai.compartment-id and, if needed, set embabel.agent.platform.models.ocigenai.authentication-type to FILE, INSTANCE_PRINCIPAL, RESOURCE_PRINCIPAL, WORKLOAD_IDENTITY, SESSION_TOKEN or SIMPLE. When the standard OpenAI provider is not on the classpath, the OCI starter supplies OCI defaults for Embabel's default LLM and embedding model:

embabel.models.default-llm=cohere.command-a-03-2025
embabel.models.default-embedding-model=cohere.embed-v4.0

Override those values in application configuration if you want another OCI model. Use OCI model ids such as cohere.command-a-03-2025 or meta.llama-3.3-70b-instruct for Embabel model selection. The Spring bean names registered by the starter are Java-friendly aliases such as cohere_command_a and llama_33_70b. If your application exposes Spring Boot Actuator env or configprops values, keep those endpoints secured and ensure OCI credential fields such as pass-phrase, session-token and private-key are sanitized.

Custom LLMs

You can define an LLM for any provider for which a Spring AI ChatModel is available.

Simply define Spring beans of type Llm. See the OpenAiConfiguration class as an example.

Remember:

Provide the knowledge cutoff date if you know it
Make the configuration class conditional on any required API key.

Roadmap

This project is in its early stages, but we have big plans. The milestones and issues in this repository are a good reference. Our key goals:

Become the natural way to Gen AI-enable Java applications, and especially those built on Spring.
Prove the power of the approach. Demonstrate that this approach is the best way to build safe, dependable, Gen AI applications. In particular:
- Demonstrate the power of extensibility without modification, by adding goals and actions
- Demonstrate the potential to become the PaaS for natural language
- Demonstrate the potential of agent federation within the GOAP model
- Demonstrate budget-aware agents, such as "Research the following topic, spending up to 20c if you are still learning"
- Integrate with data stores and demonstrate the power of surfacing existing functionality inside an organization
Take the model to other platforms: The conceptual framework is not JVM specific. Once established, we intend to create TypeScript and Python projects.

There is a lot to do, and you are awesome. We look forward to your contribution!

Application Design

Domain objects

Applications center around domain objects. These can be instantiated by LLMs or user code, and manipulated by user code.

Use Jackson annotations to help LLMs with descriptions as well as mark fields to ignore. For example:

@JsonClassDescription("Person with astrology details")
data class StarPerson(
    override val name: String,
    @get:JsonPropertyDescription("Star sign")
    val sign: String,
) : Person

See Java Json Schema Generation - Module Jackson for documentation of the library used.

Domain objects can have behaviors that are automatically exposed to LLMs when they are in scope. Simply annotate methods with the Spring AI @Tool annotation.

When exposing @Tool methods on domain objects, be sure that the tool is safe to invoke. Even the best LLMs can get trigger-happy. For example, be careful about methods that can mutate or delete data. This is likely better modeled via an explicit call to a non-tool method on the same domain class, in a code action.

Using Embabel as an MCP server

You can use the Embabel agent platform as an MCP server from a UI like Claude Desktop. The Embabel MCP server is available over SSE.

Configure Claude Desktop as follows in your claude_desktop_config.yml:

{
  "mcpServers": {
    "embabel": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://localhost:8080/sse"
      ]
    }
  }
}

See MCP Quickstart for Claude Desktop Users for how to configure Claude Desktop.

The MCP Inspector is a helpful tool for interacting with your Embabel SSE server, manually invoking tools and checking the exposed prompts and resources.

Start the MCP Inspector with:

npx @modelcontextprotocol/inspector

Consuming MCP Servers

The Embabel Agent Framework provides built-in support for consuming Model Context Protocol (MCP) servers, allowing you to extend your applications with powerful AI capabilities through standardized interfaces.

What is MCP?

Model Context Protocol (MCP) is an open protocol that standardizes how applications provide context and extra functionality to large language models. Introduced by Anthropic, MCP has emerged as the de facto standard for connecting AI agents to tools, functioning as a client-server protocol where:

Clients (like Embabel Agent) send requests to servers
Servers process those requests to deliver necessary context to the AI model

MCP simplifies integration between AI applications and external tools, transforming an "M×N problem" into an "M+N problem" through standardization - similar to what USB did for hardware peripherals.

Configuring MCP in Embabel Agent

To configure MCP servers in your Embabel Agent application, add the following to your application.yml:

spring:
  ai:
    mcp:
      client:
        enabled: true
        name: embabel
        version: 1.0.0
        request-timeout: 30s
        type: SYNC
        stdio:
          connections:
            docker-mcp:
              command: docker
              args:
                - run
                - -i
                - --rm
                - alpine/socat
                - STDIO
                - TCP:host.docker.internal:8811

This configuration sets up an MCP client that connects to a Docker-based MCP server. The connection uses STDIO transport through Docker's socat utility to connect to a TCP endpoint.

Docker Desktop MCP Integration

Docker has embraced MCP with their Docker MCP Catalog and Toolkit, which provides:

Centralized Discovery - A trusted hub for discovering MCP tools integrated into Docker Hub
Containerized Deployment - Run MCP servers as containers without complex setup
Secure Credential Management - Centralized, encrypted credential handling
Built-in Security - Sandbox isolation and permissions management

The Docker MCP ecosystem includes over 100 verified tools from partners like Stripe, Elastic, Neo4j, and more, all accessible through Docker's infrastructure.

Learn More

A2A

Embabel integrates with the A2A protocol, allowing you to connect to other A2A-enabled agents and services.

Enable the a2a Spring profile to start the A2A server.

You'll need the following environment variable:

GOOGLE_STUDIO_API_KEY: Your Google Studio API key, which is used for Gemini.

Start the Google A2A web interface using the a2a Docker profile:

docker compose --profile a2a up

Go to the web interface running within the container at http://localhost:12000/.

Connect to your agent at host.docker.internal:8080/a2a. Note that localhost:8080/a2a won't work as the server cannot access it when running in a Docker container.

Running Tests

Unit tests

Run the unit tests via Maven. This will not require an internet connection or any external services.

mvn test

Integration tests

Integration tests (*IT) hit real provider APIs and are excluded from the default mvn test run. To run them, ensure the following environment variables are set:

OPENAI_API_KEY
ANTHROPIC_API_KEY
DEEPSEEK_API_KEY
MISTRAL_API_KEY

Then run:

mvn -Dtest='*IT,!LLMOllama*IT' -Dsurefire.failIfNoSpecifiedTests=false test

This runs all integration tests except Ollama (which requires a local Ollama server). To run a specific module's integration tests, add -pl:

mvn -Dtest='*IT,!LLMOllama*IT' -Dsurefire.failIfNoSpecifiedTests=false test -pl embabel-agent-openai

Spring profiles

Spring profiles are used to configure the application for different environments and behaviors.

Model profiles:

docker-desktop: Talking to Docker Desktop with the MCP extension. This is recommended for the best experience, with Docker-provided web tools.

Logging profiles:

severance: Severance specific logging. Praise Kier!
starwars: Star Wars specific logging. Feel the force
colossus: Colossus specific logging. The Forbin Project.

Testing

A key goal of this framework is ease of testing. Just as Spring eased testing of early enterprise Java applications, this framework facilitates testing of AI applications.

Types of testing:

Unit tests: All agents are unit testable, like any Spring-managed beans. Construct them with mock objects; call individual action methods. The testing library facilitates testing prompts.
Integration tests: tbd

Logging

All logging in this project is either debug logging in the relevant class itself, or results from the stream of events of type AgentEvent.

Edit application.yml if you want to see debug logging from the relevant classes and packages.

Available logging experiences:

severance: Severance logging. Praise Kier
starwars: Star Wars logging. Feel the force. The default as it's understood throughout the galaxy.
colossus: Colossus logging. The Forbin Project.
montypython: Monty Python logging. No one expects it.
hh: Hitchhiker's Guide to the Galaxy logging. The answer is 42.

If none of these profiles is chosen, Embabel will use vanilla logging. This makes me sad.

Adding Embabel Agent Framework to Your Project

Maven Central Availability

Since version 0.2.0, Embabel Agent Framework is available directly on Maven Central, simplifying dependency management. You no longer need to configure custom repositories for stable releases.

Maven

For version 0.2.0 and above (Recommended)

Simply add the Embabel Spring Boot starter dependency to your pom.xml:


<dependency>
    <groupId>com.embabel.agent</groupId>
    <artifactId>embabel-agent-starter</artifactId>
    <version>${embabel-agent.version}</version>
</dependency>

No additional repository configuration is needed! Maven Central is configured by default.

For versions prior to 0.2.0 or for SNAPSHOT versions

You need to add the Embabel repositories to your pom.xml:


<repositories>
    <repository>
        <id>embabel-releases</id>
        <url>https://repo.embabel.com/artifactory/libs-release</url>
        <releases>
            <enabled>true</enabled>
        </releases>
        <snapshots>
            <enabled>false</enabled>
        </snapshots>
    </repository>
    <repository>
        <id>embabel-snapshots</id>
        <url>https://repo.embabel.com/artifactory/libs-snapshot</url>
        <releases>
            <enabled>false</enabled>
        </releases>
        <snapshots>
            <enabled>true</enabled>
        </snapshots>
    </repository>
</repositories>

Then add the dependency:


<dependency>
    <groupId>com.embabel.agent</groupId>
    <artifactId>embabel-agent-starter</artifactId>
    <version>${embabel-agent.version}</version>
</dependency>

Gradle (Kotlin DSL)

For version 0.2.0 and above (Recommended)

Add the required repositories to your build.gradle.kts:

repositories {
    mavenCentral()
    maven {
        name = "Spring Milestones"
        url = uri("https://repo.spring.io/milestone")
    }
}

Add the Embabel Agent starter:

dependencies {
    implementation("com.embabel.agent:embabel-agent-starter:${embabelAgentVersion}")
}

For versions prior to 0.2.0 or for SNAPSHOT versions

Add all required repositories to your build.gradle.kts:

repositories {
    mavenCentral()
    maven {
        name = "embabel-releases"
        url = uri("https://repo.embabel.com/artifactory/libs-release")
        mavenContent {
            releasesOnly()
        }
    }
    maven {
        name = "embabel-snapshots"
        url = uri("https://repo.embabel.com/artifactory/libs-snapshot")
        mavenContent {
            snapshotsOnly()
        }
    }
    maven {
        name = "Spring Milestones"
        url = uri("https://repo.spring.io/milestone")
    }
}

Add the Embabel Agent starter:

dependencies {
    implementation("com.embabel.agent:embabel-agent-starter:${embabelAgentVersion}")
}

Gradle (Groovy DSL)

For version 0.2.0 and above (Recommended)

Add the required repositories to your build.gradle:

repositories {
    mavenCentral()
    maven {
        name = 'Spring Milestones'
        url = 'https://repo.spring.io/milestone'
    }
}

Add the Embabel Agent starter:

dependencies {
    implementation "com.embabel.agent:embabel-agent-starter:${embabelAgentVersion}"
}

For versions prior to 0.2.0 or for SNAPSHOT versions

Add all required repositories to your build.gradle:

repositories {
    mavenCentral()
    maven {
        name = 'embabel-releases'
        url = 'https://repo.embabel.com/artifactory/libs-release'
        mavenContent {
            releasesOnly()
        }
    }
    maven {
        name = 'embabel-snapshots'
        url = 'https://repo.embabel.com/artifactory/libs-snapshot'
        mavenContent {
            snapshotsOnly()
        }
    }
    maven {
        name = 'Spring Milestones'
        url = 'https://repo.spring.io/milestone'
    }
}

Add the Embabel Agent starter:

dependencies {
    implementation 'com.embabel.agent:embabel-agent-starter:${embabelAgentVersion}'
}

Important Notes

Spring Milestones Repository

The Spring Milestones repository is required because the Embabel BOM (embabel-agent-dependencies) has transitive dependencies on experimental Spring components, specifically the mcp-bom. This BOM is not available on Maven Central and is only published to the Spring milestone repository.

Note for Gradle users: Unlike Maven, Gradle does not inherit repository configurations declared in parent POMs or BOMs. Therefore, it is necessary to explicitly declare the Spring milestone repository in your repositories block to ensure proper resolution of all transitive dependencies.

Repository Types

Maven Central (since v0.2.0): For stable releases 0.2.0 and above
Embabel Releases Repository: For stable releases prior to 0.2.0
Embabel Snapshots Repository: For development/snapshot versions (e.g., 0.3.0-SNAPSHOT)

Quick Start Examples

Maven with latest stable version


<dependency>
    <groupId>com.embabel.agent</groupId>
    <artifactId>embabel-agent-starter</artifactId>
    <version>0.3.0</version>
</dependency>

Gradle Kotlin DSL with latest stable version

implementation("com.embabel.agent:embabel-agent-starter:0.3.0")

Gradle Groovy DSL with latest stable version

implementation 'com.embabel.agent:embabel-agent-starter:0.3.0'

Getting Started with Observability

Add full tracing and metrics to your Embabel agents with zero code changes.

1. Add the dependency

<dependency>
    <groupId>com.embabel.agent</groupId>
    <artifactId>embabel-agent-starter-observability</artifactId>
    <version>${embabel-agent.version}</version>
</dependency>

2. Add an exporter

Pick one (or combine multiple):

Zipkin (simplest — no account needed):

<dependency>
    <groupId>io.opentelemetry</groupId>
    <artifactId>opentelemetry-exporter-zipkin</artifactId>
</dependency>

Langfuse (LLM-focused observability):

<dependency>
    <groupId>com.quantpulsar</groupId>
    <artifactId>opentelemetry-exporter-langfuse</artifactId>
    <version>0.4.0</version>
</dependency>

3. Configure

# Enable observability
embabel:
  observability:
    enabled: true
    service-name: my-agent-app

# Enable Spring Boot tracing
management:
  tracing:
    enabled: true
    sampling:
      probability: 1.0

  # Zipkin exporter
  zipkin:
    tracing:
      endpoint: http://localhost:9411/api/v2/spans

To use Langfuse instead of (or alongside) Zipkin:

management:
  langfuse:
    enabled: true
    endpoint: https://cloud.langfuse.com/api/public/otel  # or your self-hosted URL
    public-key: pk-lf-...
    secret-key: sk-lf-...

4. Start Zipkin and run

docker run -d -p 9411:9411 openzipkin/zipkin
./mvnw spring-boot:run

Open http://localhost:9411 — run an agent and you will see traces like:

Agent: CustomerServiceAgent
├── Action: AnalyzeRequest
│   └── ChatModel: gpt-4 (Spring AI)
│       └── tool:searchKnowledgeBase
├── Action: GenerateResponse
│   └── ChatModel: gpt-4 (Spring AI)
└── status: completed [duration=2340ms]

With Langfuse, you get a rich LLM-focused view of your agent traces:

What gets traced automatically

Agent lifecycle (creation, execution, completion, failures)
Every action as a child span
LLM calls with token usage (via Spring AI)
Tool invocations with input/output
Planning and replanning iterations
State transitions and lifecycle states

Track custom operations with `@Tracked`

Use the @Tracked annotation to add observability spans to your own methods — inputs, outputs, duration, and errors are captured automatically:

@Tracked("enrichCustomer")
public Customer enrich(Customer input) {
    // Your logic here
}

You can specify a type and description for richer traces:

@Tracked(value = "callPaymentApi", type = TrackType.EXTERNAL_CALL, description = "Payment gateway call")
public PaymentResult processPayment(Order order) {
    // ...
}

When called within an agent execution, @Tracked spans are automatically nested under the current action:

Agent: CustomerServiceAgent
├── Action: ProcessOrder
│   ├── @Tracked: enrichCustomer (PROCESSING)
│   ├── ChatModel: gpt-4
│   └── @Tracked: callPaymentApi (EXTERNAL_CALL)
└── status: completed

For the full configuration reference, MDC log correlation, and advanced options, see the Observability Module Documentation.

Contributing

We welcome contributions to the Embabel Agent Framework.

Look at the coding style guide for style guidelines. This file also informs coding agent behavior.

Miscellaneous

Why the name Embabel? The "babel" part is ultimately inspired by the story of the Tower of Babel, perhaps via Douglas Adams' babelfish. Per @lasuac: While Adams' fish in the ear enabled universal translation between species, Embabel aims at translating human intent to JVM code, AI models, and enterprise systems. "embabel" also sounds like "enable."
Milestone names are Australian animals. Mythical animals such as "bunyip" and "yowie" are used for futures that may or not be implemented.
README badges come from here and here.
Don't forget to join Discord to collaborate with the Embabel community. It is a good place to receive support, showcase your work, discuss ideas and connect with like-minded people.

Star history

Contributors

EchoMusicApp/Echo-Music

A modern Android music app with ad-free streaming, synced lyrics, offline playback, and an intuitive user experience.

Echo Music

A modern Android music app with ad-free streaming, synced lyrics, offline playback, and an intuitive user experience.

Overview

Echo Music delivers a seamless, premium listening experience by leveraging YouTube Music's vast library — without the ads. It adds powerful extras including offline downloads, real-time synchronized lyrics, and environment-aware music recognition.

Screenshots

Home Screen	Music Player	Synchronized Lyrics
Search & Explore	Music Library	Echo Find (Recognition)

Features

What's New

Redesigned UI — Cleaner, faster, and more intuitive interface from the ground up.
Import from Spotify — Bring your playlists and tracks over with ease.
Listen Together — Sync music in real time, similar to Spotify Jam.
Podcast Support — Listen to podcasts alongside your music library.
Local Media Support — Play music files stored directly on your device.
Dynamic Island Support — Enhanced playback notifications on supported Android devices.

Streaming & Playback

Ad-Free — Stream without any interruptions.
Seamless Playback — Switch effortlessly between audio-only and video modes.
Background Playback — Listen while using other apps or with the screen off.
Offline Mode — Download tracks, albums, and playlists via a dedicated download manager.
Crossfade — Smooth transitions between tracks.
Canvas Animations — Visual animations while playing music.

Discovery & Echo Find

Echo Find — Identify songs playing around you using advanced audio recognition.
Smart Recommendations — Personalized suggestions based on your listening history.
Comprehensive Browsing — Explore Charts, Podcasts, Moods, and Genres.

Lyrics

Multiple Lyric Animations — Choose from various lyric display styles.
Word-by-Word Lyrics — Precise per-word synchronization.
Lyrics+ — New lyrics provider for improved accuracy and coverage.
AI Translation — Built-in Google Translate integration for lyrics in any language.

Integrations

Music Sharing via Odesli — Share songs as Song.link for cross-platform listening.
Set as Ringtone — Directly set any song as your device ringtone.

Smart Playback

Pause on Mute — Auto-pause when your device is muted.
Resume on Bluetooth — Playback resumes when headphones or earbuds reconnect.

Customization

UI Density Scale — Adjust interface spacing to your preference.
High Refresh Rate Support — Smoother UI and animations on supported displays.
Hide Player Thumbnail — Keep the player minimal without album art.
Crop Album Art — Adjust album art display to fit your style.
Hide Video Songs — Filter out video content from your feed.
Hide YouTube Shorts — Keep Shorts out of your music browsing.

Installation & Setup

Android Installation

Download the latest pre-compiled APK from the Releases Page.

Building from Source

Clone the Repository

git clone https://github.com/iad1tya/Echo-Music.git
cd Echo-Music

Configure Android SDK Create a local.properties file:
```
echo "sdk.dir=/path/to/your/android/sdk" > local.properties
```
(For detailed paths on Windows/macOS/Linux, refer to SETUP.md)
Firebase Configuration (Optional) Firebase is required for analytics and crash reporting. See the instructions in SETUP.md for adding your google-services.json.
Build the Application Echo Music has two build variants: FOSS (without Google Play Services / Cast) and GMS (with Cast support).

To build the FOSS Universal Debug variant:
```
./gradlew assembleUniversalFossDebug
```
To build the GMS Universal Debug variant:
```
./gradlew assembleUniversalGmsDebug
```
(For optimized ARM64 builds, release builds, or other options, refer to SETUP.md)

Community & Support

Join the community for updates, discussions, and help.

Support the Project

If Echo Music has been useful to you, consider supporting its development.

Cryptocurrency

Network	Address
Bitcoin	`bc1qcvyr7eekha8uytmffcvgzf4h7xy7shqzke35fy`
Ethereum	`0x51bc91022E2dCef9974D5db2A0e22d57B360e700`
Solana	`9wjca3EQnEiqzqgy7N5iqS1JGXJiknMQv6zHgL96t94S`

Special Thanks

Echo Music stands on the shoulders of several excellent open-source projects. Sincere thanks to:

Project	Description
Metrolist & Vivi Music	Foundational inspiration and architecture reference
ArchiveTune	Material You UI inspiration
Better Lyrics	Lyrics enhancement and synchronization
SimpMusic	Lyrics implementation reference
Music Recognizer	Audio recognition (Echo Find)

Star History

Licensed under GPL-3.0

tiann/KernelSU

A Kernel based root solution for Android

KernelSU

A kernel-based root solution for Android devices.

Features

Kernel-based su and root access management.
Module system based on metamodules: Pluggable infrastructure for systemless modifications.
App Profile: Lock up the root power in a cage.

Compatibility state

KernelSU officially supports Android GKI 2.0 devices (kernel 5.10+). Older kernels (4.14+) are also supported, but the kernel will need to be built manually.

With this, WSA, ChromeOS, and container-based Android are all supported.

Currently, the arm64-v8a and x86_64 architectures are supported.

Caution

Recent kernel versions have implemented a breaking change causing KernelSU to fail and potentially trigger a kernel panic on x86_64! Check the website for more info!

Usage

Translation

To help translate KernelSU, we no longer accept translation contributions via Weblate. All translations are now handled using LLMs.

If you would like to add support for a new language, feel free to open a PR. Please note that modifications to existing English and Chinese translations are not accepted.

Discussion

Telegram: @KernelSU

Security

For information on reporting security vulnerabilities in KernelSU, see SECURITY.md.

License

Files under the kernel directory are GPL-2.0-only.
All other parts except the kernel directory are GPL-3.0-or-later.

Credits

Kernel-Assisted Superuser: The KernelSU idea.
Magisk: The powerful root tool.
genuine: APK v2 signature validation.
Diamorphine: Some rootkit skills.

rikkahub/rikkahub

RikkaHub is an Android APP that supports for multiple LLM providers.

RikkaHub

A native Android LLM chat client that supports switching between different providers for conversations 🤖💬

Click to join our Discord server 👉 【RikkaHub】

简体中文 | 繁體中文 | English

🚀 Download

🔗 Download from Website

🔗 Download from Google Play

💖 Sponsors

Aihubmix

Thanks to aihubmix.com for their financial support. We recommend using aihubmix as a one-stop shop for mainstream models worldwide. (OpenAI, Claude, Google Gemini, DeepSeek, Qwen, and hundreds more).

✨ Features

🎨 Material You Design and 🌙 Dark mode
🔄 Multiple AI Provider Support: custom API / URL / models (all OpenAI, Google, Anthropic compatible api)
🖼️ Multimodal input support (Image, Text Documentation, PDF, Docx)
🖥️ Web access for multi-platform use
🛠️ MCP support
📝 Markdown Rendering (with code highlighting, Latex formulas, tables, Mermaid)
🪾 Message Branching
🔍 Search capabilities (Exa, Tavily, Zhipu, LinkUp, Brave, Perplexity, etc.)
🧩 Prompt variables (model name, time, etc.)
🤳 QR code export and import for providers
🤖 Agent customization
🧠 ChatGPT-like memory feature
📝 AI Translation
🌐 Custom HTTP request headers and request bodies
💌 Silly Tavern character card import

✨ Contributing

This project is developed using Android Studio. PRs are welcome!

Technology stack documentation:

Kotlin (Development language)
Koin (Dependency Injection)
Jetpack Compose (UI framework)
DataStore (Preference data storage)
Room (Database)
Coil (Image loading)
Material You (UI design)
Navigation Compose (Navigation)
Okhttp (HTTP client)
kotlinx.serialization (JSON serialization)
compose-icons/lucide (Icon library)

Tip

You need a google-services.json file at app folder to build the app.

Important

The following PRs will be rejected:

Translation related changes, such as adding new languages or updating existing translations
Adding new features, this project is opinionated and will not accept pull requests for new features
Large-scale refactoring and changes generated by AI

💰 Donate

⭐ Star History

If you like this project, please give it a star ⭐

📄 License

License

theovilardo/PixelPlayer

privacy-first Android music player built with Material 3 Expressive. Play offline, sync lyrics, fine-tune with equalizer presets, and cast to your devices.

PixelPlayer 🎵

A beautiful, feature-rich music player for Android
Built with Jetpack Compose and Material Design 3

‼️ DISCLAIMER

No fork of this project will recieve support, if you use a fork, ask the forker to support you.

✨ Features

🎨 Modern UI/UX

Material You - Dynamic color theming that adapts to your wallpaper
Smooth Animations - Fluid transitions and micro-interactions
Customizable UI - Adjustable corner radius and navigation bar settings
Dark/Light Theme - Automatic or manual theme switching
Album Art Colors - Dynamic color extraction from album artwork

🎵 Powerful Playback

Media3 ExoPlayer - Industry-leading audio engine with FFmpeg support
Background Playback - Full media session integration
Queue Management - Drag-and-drop reordering
Shuffle & Repeat - All playback modes supported
Gapless Playback - Seamless transitions between tracks
Custom Transitions - Configure crossfades between songs

📚 Library Management

Multi-format Support - MP3, FLAC, AAC, OGG, WAV, and more
Browse By - Songs, Albums, Artists, Genres, Folders
Smart Artist Parsing - Configurable delimiters for multi-artist tracks
Album Artist Grouping - Proper album organization
Folder Filtering - Choose which directories to scan

🔍 Discovery & Organization

Full-text Search - Search across your entire library
Daily Mix - AI-powered personalized playlist based on listening habits
Playlists - Create and manage custom playlists
Statistics - Track your listening history and habits

🎤 Lyrics

Synchronized Lyrics - LRC format via LRCLIB API
Lyrics Editing - Modify or add lyrics to your tracks
Scrolling Display - Follow along as you listen

🖼️ Artist Artwork

Deezer Integration - Automatic artist images from Deezer API
Smart Caching - Memory (LRU) + database caching for offline access
Fallback Icons - Beautiful placeholders when images unavailable

📲 Connectivity

Chromecast - Stream to your TV or smart speakers
Android Auto - Full Android Auto support for in-car playback (Soon)
Widgets - Home screen control with Glance widgets

⚙️ Advanced Features

Tag Editor - Edit metadata with TagLib (MP3, FLAC, M4A support)
AI Playlists - Generate playlists with AI (Supports Gemini, Deepseek, OpenAI, etc.)

🛠️ Tech Stack

Category	Technology
Language	Kotlin 100%
UI Framework	Jetpack Compose
Design System	Material Design 3
Audio Engine	Media3 ExoPlayer + FFmpeg
Architecture	MVVM with StateFlow/SharedFlow
DI	Hilt
Database	Room
Networking	Retrofit + OkHttp
Image Loading	Coil
Async	Kotlin Coroutines & Flow
Background Tasks	WorkManager
Metadata	TagLib
Widgets	Glance

📱 Requirements

Android 11 (API 30) or higher
6GB RAM recommended for smooth performance

🚀 Getting Started

Prerequisites

Android Studio Ladybug | 2024.2.1 or newer
Android SDK 29+
JDK 11+

Installation

Clone the repository

git clone https://github.com/theovilardo/PixelPlayer.git

Open in Android Studio
- Open Android Studio
- Select "Open an Existing Project"
- Navigate to the cloned directory
Sync and Build
- Wait for Gradle to sync dependencies
- Build the project (Build → Make Project)
Run
- Connect a device or start an emulator
- Click Run (▶️)

⬇️ Download

📂 Project Structure

app/src/main/java/com/theveloper/pixelplay/
├── data/
│   ├── database/       # Room entities, DAOs, migrations
│   ├── model/          # Domain models (Song, Album, Artist, etc.)
│   ├── network/        # API services (LRCLIB, Deezer)
│   ├── preferences/    # DataStore preferences
│   ├── repository/     # Data repositories
│   ├── service/        # MusicService, HTTP server
│   └── worker/         # WorkManager sync workers
├── di/                 # Hilt dependency injection modules
├── presentation/
│   ├── components/     # Reusable Compose components
│   ├── navigation/     # Navigation graph
│   ├── screens/        # Screen composables
│   └── viewmodel/      # ViewModels
├── ui/
│   ├── glancewidget/   # Home screen widgets
│   └── theme/          # Colors, typography, theming
└── utils/              # Extensions and utilities

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Fork the Project
Create your Feature Branch (git checkout -b feature/AmazingFeature)
Commit your Changes (git commit -m 'Add some AmazingFeature')
Push to the Branch (git push origin feature/AmazingFeature)
Open a Pull Request

📄 License

This project is licensed under a Proprietary License - see the LICENSE file for details.

Made with ❤️ by theovilardo

hectorqin/reader

阅读3服务器版，桌面端，iOS可用。后端 Kotlin + Spring Boot + Vert.x + Coroutine ；前端 Vue.js + Element。麻烦点点star，关注一下公众号【假装大佬】❗️

reader

阅读3服务器版，不需要手机。

加入TG群(限时开放) 👉 https://t.me/+pQ8HDlANPZ84ZWNl

关注公众号，查看教程和书源👇

注意❗️

Reader 完整源码仅开放到 v2.5.4，新版本当前仅开放部分开源源码，见 https://github.com/hectorqin/reader-legado.

免责声明（Disclaimer）

阅读是一款提供网络文学搜索的工具，为广大网络文学爱好者提供一种方便、快捷舒适的试读体验。

当您搜索一本书的时，阅读会将该书的书名以关键词的形式提交到各个第三方网络文学网站。各第三方网站返回的内容与阅读无关，阅读对其概不负责，亦不承担任何法律责任。任何通过使用阅读而链接到的第三方网页均系他人制作或提供，您可能从第三方网页上获得其他服务，阅读对其合法性概不负责，亦不承担任何法律责任。第三方搜索引擎结果根据您提交的书名自动搜索获得并提供试读，不代表阅读赞成或被搜索链接到的第三方网页上的内容或立场。您应该对使用搜索引擎的结果自行承担风险。

阅读不做任何形式的保证：不保证第三方搜索引擎的搜索结果满足您的要求，不保证搜索服务不中断，不保证搜索结果的安全性、正确性、及时性、合法性。因网络状况、通讯线路、第三方网站等任何原因而导致您不能正常使用阅读，阅读不承担任何法律责任。阅读尊重并保护所有使用阅读用户的个人隐私权，您注册的用户名、电子邮件地址等个人资料，非经您亲自许可或根据相关法律、法规的强制性规定，阅读不会主动地泄露给第三方。

阅读致力于最大程度地减少网络文学阅读者在自行搜寻过程中的无意义的时间浪费，通过专业搜索展示不同网站中网络文学的最新章节。阅读在为广大小说爱好者提供方便、快捷舒适的试读体验的同时，也使优秀网络文学得以迅速、更广泛的传播，从而达到了在一定程度促进网络文学充分繁荣发展之目的。阅读鼓励广大小说爱好者通过阅读发现优秀网络小说及其提供商，并建议阅读正版图书。任何单位或个人认为通过阅读搜索链接到的第三方网页内容可能涉嫌侵犯其信息网络传播权，应该及时向阅读提出书面权力通知，并提供身份证明、权属证明及详细侵权情况证明。阅读在收到上述法律文件后，将会依法尽快断开相关链接内容。

功能说明

书源管理
- 书架管理
- 书架布局
- 搜索
- 书海
- 看书
- 移动端适配
- 换源
- 翻页方式
- 手势支持
- 自定义主题
- 自定义样式
- WebDAV同步
- 文字替换过滤
- 听书<仅部分浏览器支持，手机端会因为锁屏而失效>
- 用户配置备份恢复
- 支持漫画
- 支持音频
- 书源失效检测
- 导入本地TXT、EPUB、UMD、PDF格式的书籍
- 书籍分组
- RSS订阅
- 定时更新书架
- 并发搜书
- 本地书仓
- 支持kindle阅读

下载与安装

详见文档

问题

部分使用了 Javascript 的书源可能会报错，如调用原生java等高级Javascript功能
webview 功能需要另外部署接口，不支持 sourceRegex 匹配资源响应
不支持书源登录功能

感谢

项目初期参考了 lightink-小说API
阅读
阅读3.0
项目初期参考了阅读3.0Web端

其它

dovecoteescapee/ByeDPIAndroid

App to bypass censorship on Android

ByeDPI for Android

English | Русский

Android application that runs a local VPN service to bypass DPI (Deep Packet Inspection) and censorship.

This application runs a SOCKS5 proxy ByeDPI and redirects all traffic through it.

Installation

Or use Obtainium

Install Obtainium
Add the app by URL:
https://github.com/dovecoteescapee/ByeDPIAndroid

Settings

To bypass some blocks, you may need to change the settings. More about the various settings can be found in the ByeDPI documentation.

FAQ

I can't configure it. What to do?

You can ask for help in discussion.

Does the application require root access?

No. All application features work without root.

Is this a VPN?

No. The application uses the VPN mode on Android to redirect traffic, but does not send anything to a remote server. It does not encrypt traffic and does not hide your IP address.

How to use ByeDPI with AdGuard?

Run ByeDPI in proxy mode.
Add ByeDPI to AdGuard exceptions on the "App management" tab.

In AdGuard settings, specify the proxy:

Proxy type: SOCKS5
Proxy host: 127.0.0.1
Proxy port: 1080 (default)

What data does the application collect?

None. The application does not send any data to a remote server. All traffic is processed on the device.

Are there any for other platforms?

Similar projects)

What is DPI?

DPI (Deep Packet Inspection) is a technology for analyzing and filtering traffic. It is used by providers and government agencies to block sites and services.

Dependencies

Building

For building the application, you need:

JDK 8 or later
Android SDK
Android NDK
CMake 3.22.1 or later

To build the application:

Clone the repository with submodules:
```
git clone --recurse-submodules
```
Run the build script from the root of the repository:
```
./gradlew assembleRelease
```
The APK will be in app/build/outputs/apk/release/

open-ani/animeko

集找番、追番、看番的一站式弹幕追番平台，云收藏同步 (Bangumi)，离线缓存，BitTorrent，弹幕云过滤。100% Kotlin/Compose Multiplatform

正式版	测试版	讨论群

Animeko 支持云同步观看记录 (Bangumi)、多视频数据源、缓存、弹幕、以及更多功能，提供尽可能简单且舒适的追番体验。

Animeko 曾用名 Ani，现在也简称 Ani。

立即下载

https://github.com/user-attachments/assets/e63636c9-30b7-411c-aa6b-e5b78b900726

主要功能

浏览来自 Bangumi 的番剧信息以及社区评价

丰富的检索方式：新番时间表、标签搜索

由 Bangumi 和 Animeko 服务端共同提供的精确新番时间表

云同步追番进度

省心的追番进度管理，看完视频自动更新进度
打开 APP 立即继续观看，无需回想上次看到了哪

聚合数据源

聚合视频数据源，全自动选择

还支持 BitTorrent、Jellyfin、Emby、以及自定义源
聚合全网弹幕源（弹弹play），以及 Animeko 自己的弹幕服务

离线缓存

所有数据源都能缓存

精美界面

适配平板和大屏设备

下载

Animeko 支持所有主流平台：Android、iOS、Windows、macOS、Linux。

稳定版本: 每两周更新, 功能稳定
下载稳定版本

通常建议使用稳定版本. 如果你愿意参与测试并拥有一定的对 bug 的处理能力, 也欢迎使用测试版本更快体验新功能. 具体版本类型可查看下方.

测试版本: 每两天更新, 体验最新功能
下载测试版本

点击查看具体版本类型

Animeko 采用语义化版本号, 简单来说就是 4.x.y 的格式. 有以下几种版本类型:

稳定版本:
- 新特性发布: 当 x 更新时, 会有新特性的发布. 通常为 2 周一次.
- Bug 修复: 当 y 更新时, 只会有针对前个版本的重要的 bug 修复. 这些 Bug 修复版本穿插在新特性更新的间隔中, 时间不固定.
在稳定版本的发布周期之间, 会发布测试版本:
- Alpha 测试版: 所有重大新功能都会首先发布到 alpha 测试通道, 客户端内可使用 "每日构建" 接收更新. 这些新功能非常不稳定, 适合热情的先锋测试员!
- Beta 测试版: 在功能经过 alpha 测试修复重大问题后, 会进入 beta 测试通道, 在客户端内名称为 "测试版". 此版本仍然不稳定, 是一个平衡新功能和稳定性的选择

技术总览

如果你是开发者，我们总是欢迎你提交 PR 参与开发！以下几点可以给你一个技术上的大概了解。

Kotlin 多平台架构；
使用新一代响应式 UI 框架 Compose Multiplatform 构建 UI；
内置专为 Animeko 打造的“基于 libtorrent 的 BitTorrent 引擎，优化边下边播的体验；
高性能弹幕引擎，公益弹幕服务器 + 网络弹幕源；
适配多平台的视频播放器，Android 底层为 ExoPlayer，PC 底层为 VLC；
多类型数据源适配，内置动漫花园、Mikan，拥有强大的自定义数据源编辑器和自动数据源选择器。

参与开发

欢迎你提交 PR 参与开发，有关项目技术细节请参考 CONTRIBUTING。

FAQ

资源来源是什么?

全部视频数据都来自网络, Animeko 本身不存储任何视频数据。 Animeko 支持两大数据源类型：BT 和在线。BT 源即为公共 BitTorrent P2P 网络，每个在 BT 网络上的人都可分享自己拥有的资源供他人下载。在线源即为其他视频资源网站分享的内容。Animeko 本身并不提供任何视频资源。

本着互助精神，使用 BT 源时 Animeko 会自动做种 (分享数据)。 BT 指纹为 -AL4123-，其中 4123 为版本号 4.12.3；UA 为类似 ani_libtorrent/4.12.3。

弹幕来源是什么?

Animeko 拥有自己的公益弹幕服务器，在 Animeko 应用内发送的弹幕将会发送到弹幕服务器上。每条弹幕都会以 Bangumi 用户名绑定以防滥用（并考虑未来增加举报和屏蔽功能）。

Animeko 还会从弹弹play获取关联弹幕，弹弹play还会从其他弹幕平台例如哔哩哔哩港澳台和巴哈姆特获取弹幕。番剧每集可拥有几十到几千条不等的弹幕量。

yairm210/Unciv

Open-source Android/Desktop remake of Civ V

Unciv - Civ V remake for Android & Desktop

What is this?

An open source, moddability-focused Android and Desktop remake of Civ V, made with LibGDX.

Is this any good?

Depends what you're looking for. If you're in the market for high-res graphics, amazing soundtracks, animations etc, I highly recommend Firaxis's Civ-V-like game, "Civilization V".

If you want a small, fast, moddable, FOSS, in-depth 4X that can still run on a potato, you've come to the right place 😃

How do I install?

Android - Google Play or F-droid
Linux - itch.io, Flatpak via Flathub, or AUR
Windows - Grab the MSI, or get from itch.io, Chocolatey, or Scoop
Raspberry Pi - Pi-apps
MacOS - Via Brew (brew update && brew install unciv) or install with this guide
Jars, APKs and Windows/Linux builds also available in Releases (run jar with java -jar Unciv.jar) - not recommended since we update frequently and you will quickly become out-of-date
Build from scratch if that's your thing

What's the roadmap?

In this order:

Polish!
- UI+UX improvements (suggestions welcome!)
- Better automation, AI etc. in-game
G&K mechanics - see #4697
BNW mechanics - trade routes, world congress, etc.

Contributing

Programmers start here!

Translators start here! Language completion status here

Modders start here!

You can join us in any of the open issues, or work on improving anything you want - once you're finished, issue a pull request and it'll go into the next version!

If not, you can help by spreading the word - vote for Unciv where you can, mention it on Reddit or Twitter etc, and help us with new ideas of how to get the word out!

FAQ

How about iOS?

I'm not planning on it. It means paying money to Apple, yet another release path, and since I don't have an iOS device it means I can't test it properly.

Steam release?

Steam has decided that they don't want to host Unciv, they probably don't want to risk legal issues with Firaxis (although those should be non-existent, see below).

Will you implement {feature}?

If it's in the original Civ V, then yes!

If not, then the feature won't be added to the base game - possibly it will be added as a way to mod the game, which is constantly expanding.

Why not? This is its own game, why not add features that weren't in Civ V?

Having a clear vision is important for actually getting things done.

Anyone can make a suggestion. Not all are good, viable, or simple. Not many can actually implement stuff.

As an open source project, this stuff is done in our spare time, of which there isn't much.

We need a clear-cut criteria to decide what to work on and what not to work on.

Will you implement Civ VI?

Considering how long it took to get this far, no.

How can I learn to play? Where's the wiki?

All the tutorial information is available in-game at menu > civilopedia > tutorials

All the information is included in the amazing Civ V wiki

Since this is a Civ V clone, you can search Google for how to play Civ V and there are loads of answers =)

Alternatively, you could join us on Discord and ask there =D

Aren't you basically making a Civ V clone? Is that even legal?

According to the US Copyright Office FL-108, intellectual property rights do not apply to mechanics - as I'm sure you know, there are a billion Flappy Bird knockoffs.

It is definitely illegal:

To use any assets from the original game (images, sound etc) - they belong to Firaxis

It is probably illegal (no solid sources on this):

To use the Civilization name
To impersonate the Civ games (so calling yourself civi|zation with a similar logo, for instance)

Interestingly, Civilization is a registered trademark, but it looks like it's only that particular logo which is trademarked, so technically you could make another game called "Civilization" and it'll stick. In any case we're not going there 😃

Run with Docker

If you have docker compose installed:

$ docker compose build && docker compose up

and then goto http://localhost:6901/vnc.html?password=headless

If just docker:

$ docker build . -t unciv && docker run -d -p 6901:6901 -p 5901:5901 unciv

Or just use our already built one:

$ docker run -d -p 6901:6901 -p 5901:5901 ghcr.io/yairm210/unciv

and then goto http://localhost:6901/vnc.html?password=headless

Credits and 3rd parties

PortSwigger/mcp-server

MCP Server for Burp

Burp Suite MCP Server Extension

Overview

Integrate Burp Suite with AI Clients using the Model Context Protocol (MCP).

For more information about the protocol visit: modelcontextprotocol.io

Features

Connect Burp Suite to AI clients through MCP
Automatic installation for Claude Desktop
Comes with packaged Stdio MCP proxy server

Usage

Install the extension in Burp Suite
Configure your Burp MCP server in the extension settings
Configure your MCP client to use the Burp SSE MCP server or stdio proxy
Interact with Burp through your client!

Installation

Prerequisites

Ensure that the following prerequisites are met before building and installing the extension:

Java: Java must be installed and available in your system's PATH. You can verify this by running java --version in your terminal.
jar Command: The jar command must be executable and available in your system's PATH. You can verify this by running jar --version in your terminal. This is required for building and installing the extension.

Building the Extension

Clone the Repository: Obtain the source code for the MCP Server Extension.
```
git clone https://github.com/PortSwigger/mcp-server.git
```
Navigate to the Project Directory: Move into the project's root directory.
```
cd mcp-server
```
Build the JAR File: Use Gradle to build the extension.
```
./gradlew embedProxyJar
```
This command compiles the source code and packages it into a JAR file located in build/libs/burp-mcp-all.jar.

Loading the Extension into Burp Suite

Open Burp Suite: Launch your Burp Suite application.
Access the Extensions Tab: Navigate to the Extensions tab.
Add the Extension:
- Click on Add.
- Set Extension Type to Java.
- Click Select file ... and choose the JAR file built in the previous step.
- Click Next to load the extension.

Upon successful loading, the MCP Server Extension will be active within Burp Suite.

Configuration

Configuring the Extension

Configuration for the extension is done through the Burp Suite UI in the MCP tab.

Toggle the MCP Server: The Enabled checkbox controls whether the MCP server is active.
Enable config editing: The Enable tools that can edit your config checkbox allows the MCP server to expose tools which can edit Burp configuration files.
Advanced options: You can configure the port and host for the MCP server. By default, it listens on http://127.0.0.1:9876.

Claude Desktop Client

To fully utilize the MCP Server Extension with Claude, you need to configure your Claude client settings appropriately. The extension has an installer which will automatically configure the client settings for you.

Currently, Claude Desktop only support STDIO MCP Servers for the service it needs. This approach isn't ideal for desktop apps like Burp, so instead, Claude will start a proxy server that points to the Burp instance,
which hosts a web server at a known port (localhost:9876).
Configure Claude to use the Burp MCP server
You can do this in one of two ways:
- Option 1: Run the installer from the extension This will add the Burp MCP server to the Claude Desktop config.
- Option 2: Manually edit the config file
  Open the file located at ~/Library/Application Support/Claude/claude_desktop_config.json, and replace or update it with the following:
```
{
  "mcpServers": {
    "burp": {
      "command": "<path to Java executable packaged with Burp>",
      "args": [
          "-jar",
          "/path/to/mcp/proxy/jar/mcp-proxy-all.jar",
          "--sse-url",
          "<your Burp MCP server URL configured in the extension>"
      ]
    }
  }
}
```
Restart Claude Desktop - assuming Burp is running with the extension loaded.

Manual installations

If you want to install the MCP server manually you can either use the extension's SSE server directly or the packaged Stdio proxy server.

SSE MCP Server

In order to use the SSE server directly you can just provide the url for the server in your client's configuration. Depending on your client and your configuration in the extension this may be with or without the /sse path.

http://127.0.0.1:9876

http://127.0.0.1:9876/sse

Stdio MCP Proxy Server

The source code for the proxy server can be found here: MCP Proxy Server

In order to support MCP Clients which only support Stdio MCP Servers, the extension comes packaged with a proxy server for passing requests to the SSE MCP server extension.

If you want to use the Stdio proxy server you can use the extension's installer option to extract the proxy server jar. Once you have the jar you can add the following command and args to your client configuration:

/path/to/packaged/burp/java -jar /path/to/proxy/jar/mcp-proxy-all.jar --sse-url http://127.0.0.1:9876

Creating / modifying tools

Tools are defined in src/main/kotlin/net/portswigger/mcp/tools/Tools.kt. To define new tools, create a new serializable data class with the required parameters which will come from the LLM.

The tool name is auto-derived from its parameters data class. A description is also needed for the LLM. You can return a string (or richer PromptMessageContents) to provide data back to the LLM.

Extend the Paginated interface to add auto-pagination support.

osfans/trime

同文安卓輸入法平臺3.x/Android-rime/Rime Input Method Engine for Android

Trime

Rime IME for Android

English | 简体中文 | 繁體中文

About

Trime is originally a frontend of open-source Android Traditional Chinese IME, based on RIME input method framework and written in Java/Kotlin with JNI. It is designed to protect the native language of various local dialects of Chinese and is a universal shape-based and phonetic-based input method platform.

Documentation

Download

Stable Channel
Nightly Channel Download
Canary Channel Download
Configurations rimerc

History

TRIME is the abbreviation of Tongwen RIME or ThaeRv Input Method.

From the beginning, TRIME was written for TaeRv Pinyin, and named TaeRv Input Method (泰如输入法).

Then, we created an input method platform with some code tables, such as Wu dialect (吴语). We renamed it to Chinese Character Dialect Input Method (汉字方言输入法).

Later, it supports Wubi and Liangbi and other shape-based input method, we branded it Tongwen Input Method Platform 2.0 (同文输入法平台 2.0), which implies that the phonetic-based and shape-based input method on one platform, while dialects and Mandrain share one kind of characters.

Benefit from the librime project by JNI, we are now in version 3.0 of TRIME aka Tongwen Input Method (同文输入法).

Your are now welcome to contribution ~ !

Getting Started for developer

Prepare

Requirements:

Android SDK and Android NDK
- If you are new to Android development, please install Android Studio.
JDK (OpenJDK) 17
Python 3 (required by OpenCC to generate dictionary text files)

Prerequisites for Windows

Symbolic links will be created according to current build configurations, developers need:

Enable Developer Mode so that symlinks can be created without administrator privilege.
Enable symlink support for git:
```
git config --global core.symlinks true
```

If you cannot or wouldn't like to enable anything, it doesn't matter. Copying will be used instead when error on creating symbolic links.

Build

1. Clone this project and fetch all submodules:

git clone git@github.com:osfans/trime.git
git submodule update --init --recursive
# use partial clone to save time
git submodule update --init --recursive --filter=blob:none

2. Debug version without signature:

# On Linux or macOS
make debug

# On Windows
.\gradlew assembleDebug

3. Release version with signture:

Create keystore.properties file which contains following contents for signing information:

storePassword=myStorePassword
keyPassword=mykeyPassword
keyAlias=myKeyAlias
storeFile=myStoreFileLocation

Then, you may run:

# On Linux or macOS
make release

# On Windows
.\gradlew assembleRelease

Troubleshooting

Target "boost_log_setup" links to target "Boost::coroutine" but the target was not found.

Run make clean on Linux or macOS, or run .\gradlew clean on Windows.

Other issues:

Try make clean
Make sure your repo is up-to-date. If one or more submodules are modified, also make sure they are compatible with the current version.
If the problem still exists(very unlikely), try to make a new clone.
Check if this is there is an issue/PR related to your problem. If yes, try their solutions.
If none of them works, you may make an issue to ask for help.(optional)

Acknowledgments

Developer: osfans
Contributors: boboIqiqi、Bambooin、senchi96、heiher、abay、iovxw、huyz-git、tumuyan、WhiredPlanck、nopdan...
Wiki Editors: xiaoqun2016、boboIqiqi...
Translators: 天真可爱的满满 (Chinese Traditional), 点解 (English) ...
Keyboard Designers: 天真可爱的满满、皛筱晓小笨鱼、吴琛 11、熊猫阿 Bo、默默ㄇㄛ ˋ...
Donations: See QR Code in Releases
Community: Netizens who feedback in Issues、QQ Group (811142286)、QQ Group (224230445)、Tieba、Google Play、Telegram...
Projects: RIME、OpenCC、Android Traditional Chinese IME and so on.

Third Party Libraries

Boost C++ Libraries (Boost Software License)
darts-clone (New BSD License)
LevelDB (New BSD License)
libiconv (LGPL License)
marisa-trie (BSD License)
glog (New BSD License)
OpenCC (Apache License 2.0)
RIME (BSD License)
snappy(BSD License)
utfcpp (Boost Software License)
yaml-cpp (MIT License)
Android Traditional Chinese IME (Apache License 2.0)

home-assistant/android

Home Assistant Companion for Android

Welcome to the Home Assistant Companion for Android! This is the official Android app for Home Assistant, a powerful open-source home automation platform. Join us in building an app used by millions of users worldwide.

Features

Control Your Smart Home: Seamlessly interact with your Home Assistant instance.
Native Android Experience: Leverage Android-specific features like widgets, notifications, and location tracking.
Customizable: Tailor the app to your needs with themes, dashboards, and more.
Open Source: Contribute to a project that empowers users to take control of their smart homes.

Get the app

Download from the Play Store
Join the Play Store Beta to test new features early.
Other Stores: The app is also available in other app stores.

Documentation

Looking for help? Check out the Home Assistant Companion Documentation for detailed guides on using the app.

Report a bug or request a feature

Found a bug or have an idea for a new feature? Let us know!

Open a Bug Report
Request a Feature

We appreciate your feedback and contributions to make the app even better!

Contributing

We are thrilled to welcome contributions from the community! This app exists thanks to the incredible efforts of the Home Assistant community. Whether you're fixing bugs, adding new features, or improving documentation, your contributions make a difference.

Every contribution, big or small, is greatly appreciated. Together, we can make the Home Assistant Companion for Android even better!

Getting started

Read the Developer Guide.
Fork the repository and create a branch for your changes.
Submit a pull request and join the discussion!

Join the community

Connect with other contributors and users in our vibrant Discord Community: Join the #Android channel to chat with developers and contributors.

Star the repository

If you find this project useful, consider giving it a star on GitHub!
It helps others discover the project and motivates us to keep improving.

ReVanced/revanced-manager

💊 Application to use ReVanced on Android

Continuing the legacy of Vanced

💊 ReVanced Manager

Application to use ReVanced on Android

❓ About

ReVanced Manager is an application that uses ReVanced Patcher to patch Android apps.

💪 Features

Some of the features ReVanced Manager provides are:

⬇️ Download: Automatically download apps using the ReVanced Manager downloader system
💉 Patch: Select and apply patches to any Android app
🛠️ Customize: Manage patches, apps, signing, themes, updates, and many more settings

🔽 Download

You can download the most recent version of ReVanced Manager at revanced.app/download or from GitHub releases.
Learn how to use ReVanced Manager by following the documentation.

📚 Everything else

📙 Contributing

Thank you for considering contributing to ReVanced Manager. You can find the contribution guidelines here.

🛠️ Building

To build a ReVanced Manager, you can follow the documentation.

📄 Documentation

You can find the documentation for ReVanced Manager here.

⚖️ License

ReVanced Manager is licensed under the GPLv3 license. Please see the license file for more information. tl;dr you may copy, distribute and modify ReVanced Manager as long as you track changes/dates in source files. Any modifications to ReVanced Manager must also be made available under the GPL, along with build & install instructions.

yuzono/anime-extensions

Install on Aniyomi	Install on Anikku	Build	Discord

Anikku/Aniyomi Extensions

Anikku/Aniyomi is a free and open source anime player for Android 6.0 and above.

This repository contains the available extension catalogues for the Anikku or Aniyomi forks.

Recommend App

Anikku

Aniyomi

How to add the repo

If you are new to repository/extensions, please read the Yūzōnō Getting Started guide first.

You can add our repo by visiting the Yūzōnō Website
Otherwise, copy & paste the following URL:

https://raw.githubusercontent.com/yuzono/anime-repo/repo/index.min.json

Manual downloads

If you prefer to directly download the APK files, they are available via website or directly in this GitHub repository in the repo branch.

Requests

To request a new source or bug fix, create an issue.

Please note that creating an issue does not mean that the source will be added or fixed in a timely fashion, because the work is volunteer-based. Some sources may also be impossible to do or prohibitively difficult to maintain.

If you would like to see a request fulfilled and have the necessary skills to do so, consider contributing! Issues are up-for-grabs for any developer if there is no assigned user already.

Contributing

Contributions are welcome!

Check out the repo's issue backlog for source requests and bug reports.

To get started with development, see CONTRIBUTING.md.

It might also be good to read our CODE_OF_CONDUCT.md.

License

Copyright 2015 Javier Tomás

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Disclaimer

This project does not have any affiliation with the content providers available.

This project is not affiliated with Anikku/Aniyomi. Don't ask for help about these extensions at the official support means of Anikku/Aniyomi. All credits to the codebase goes to the original contributors.

The developer of this application does not have any affiliation with the content providers available.

GitHub Kotlin Weekly Trending

HapeLee/legado-with-MD3

Legado with MD3

📖 介绍

✨ 分支特性

🛠️ 核心功能

❤️ 致谢

⚠️ 免责声明

SukiSU-Ultra/SukiSU-Ultra

SukiSU Ultra

Features

Compatibility Status

Installation

Integration

Translation

KPM Support

Troubleshooting

Sponsor

ShirkNeko's sponsorship list

License

Credit

koiverse/ArchiveTune

ArchiveTune

📸 Showcase

✨ Features

Playback

Audio

Lyrics & Discovery

Sync & Social

Interface

Customization

📥 Download Now

Stable Release

Nightly Build

❓ Need Help or Have Questions?

🌍 Globalization

✨ Project Contributors

🛠️ Development & Engineering

🤝 Acknowledgments

⚖️ Legal Disclaimer

2dust/v2rayNG

v2rayNG

Telegram Channel

Usage

Geoip and Geosite

More in our wiki

Development guide

wxxsfxyzm/InstallerX-Revived

InstallerX Revived (Community Edition)

Documentation

Highlights

Supported Android Versions

Downloads

Building

Prerequisites

GitHub Packages Authentication

Build Commands

Common Questions

Where should I report bugs or ask questions?

I cannot lock InstallerX as the default installer

HyperOS says installing system apps requires a valid installer

Notification installation progress is stuck

How do I replace the system package manager?

Localization

License

Acknowledgements

Star History

AAswordman/Operit

Operit AI - 智能助手应用

🌟 项目简介

⚡ 核心亮点

🖥️ Ubuntu 24 环境

🧠 智能记忆系统

🗣️ 语音交互

🤖 本地AI模型

🎭 人设与角色卡

🔌 丰富工具生态

🛠️ 功能速览

📸 功能展示

🚀 快速开始