Turtlebrowse：基于 Java CEF 的开源浏览器，内置本地智能体 AI

YouTube Video

Watch the full video on YouTube.

Download

The latest version of Turtlebrowse is available for download at turtlebrowse.ingstudios.dev.

If you want to download a previous version of Turtlebrowse, it can be found in the releases section.

Features

Powered by the Java Chromium Embedded Framework
Follows Chromium standards
Built-in Chrome DevTools and Chrome DevTools Protocol
100% local agentic AI
Dynamic Material You theme
Multiple isolated user profiles
Discord Presence toggle
YouTube and other platforms video downloader with yt-dlp
Always private, no data leaves your device
Free and open-source (FOSS)
Guest/private mode where all data from disk is deleted when closed
An integrated terminal in the sidebar
Available for Linux, Windows, and macOS on different architectures
Built-in rust-based ad-blocker featuring rules from EasyList, Fanboy's Lists, EasyPrivacy, and UBlockOrigin

Development

Turtlebrowse has reached a stable stage, but we are always looking for contributors. We welcome any sort of contributions that are human made. Here's how to build Turtlebrowse.

Read CONTRIBUTING.md for contribution guidelines.

Prerequisites

Git - Source control for Turtlebrowse
JDK 25 - Turtlebrowse is powered by Java 25 and uses the latest features
Node.js - Used to build the internal pages and website
Go 1.26.0 or higher - Used for the update microservice

Building and Running

Clone the repository

git clone https://github.com/ingStudiosOfficial/turtlebrowse.git
cd turtlebrowse

Full Build Script (POSIX complient shells only)

Turtlebrowse provides a full build script to build the entire project.

Full build script

# Relative to the root of the project
./full-build.sh

or build individual sections

Frontend pages

./build-frontend.sh

Website

./build-website.sh

Update proxy

./build-proxy.sh

Browser

Build the Gradle project

# Relative to the root of the project
cd app
./gradlew build # or ./gradlew.bat build on Windows

Run the Gradle project

./gradlew run # or ./gradlew.bat run on Windows

Internal Pages

Install dependencies

# Relative to the root of the project
cd frontend/pages
npm install

Run the pages in development mode

npm run dev

Build the pages

npm run build

Internal Games

Dino

Install dependencies

# Relative to the root of the project
cd frontend/games/dino
npm install

Run the dino game in development mode

npm run dev

Build the dino game

npm run build

Website

Install dependencies

# Relative to the root of the project
cd website
npm install

Run the website in development mode

npm run dev

Build the website

npm run build

Updates proxy

Run the Go project

# Relative to the root of the project
cd updates
go run .

Build the binary

go build -o ./build/turtlebrowseupdates .

Credits

Huge thank you to the Java Chromium Embedded Framework project for providing Java bindings to CEF and jcefmaven for providing pre-built binaries for Gradle. This project would not have been possible without them.

Notable mentions

wayou/t-rex-runner for decompiling the Chromium Dino game from the Chromium source code (I tried doing it myself but it was a pain, huge thanks!)
JetBrains/jediterm for providing integrated terminal support
sshahine/JFoenix for beautiful Material 3 JavaFX components
ollama4j/ollama4j for the Java API wrapper for Ollama
breadrock1/adblock-coffee for Java bindings for adblock-rust

The other dependencies that can be found in build.gradle.kts are also very much appredicated!

License

Turtlebrowse is licensed under the Apache 2.0 License. Check LICENSE for more details.