Turtlebrowse

A Material You themed JVM based agentic browser made in JCEF (Java Chromium Embedded Framework), Swing, and JavaFX.

YouTube Video • Download • Contributing • Changelog • License

---

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

1. 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

1. Build the Gradle project

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

2. Run the Gradle project

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

Internal Pages

1. Install dependencies

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

2. Run the pages in development mode

npm run dev

3. Build the pages

npm run build

Internal Games

Dino

1. Install dependencies

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

2. Run the dino game in development mode

npm run dev

3. Build the dino game

npm run build

Website

1. Install dependencies

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

2. Run the website in development mode

npm run dev

3. Build the website

npm run build

Updates proxy

1. Run the Go project

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

2. 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
• nurgak/Cube-engine for the cube game

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.

© 2026 (ing) Studios and Ethan Lee