GBrain Free and Open Source Desktop App CookApps CookApps Marketplace

Overview

GBrain is an open-source, high-performance solution engineered to solve foundational workflow challenges in the TypeScript ecosystem. Built on local-first principles to ensure privacy, performance, and complete data ownership, it provides a unified architecture for modern developers and technical power users.

How It Works

GBrain operates through structured, deterministic execution stages:

Multi-Source Knowledge Ingestion: Captures developer context, system notes, web pages, and MCP tool interactions into a local structured memory graph.

Schema Pack Organization: Structures raw agent logs across curated domains (workspaces, active projects, and system heuristics) using Postgres and PGlite.

Autonomous Agent Loop: Executes continuous observe-orient-decide-act cycles to formulate actionable next steps for coding and research tasks.

Context Injection & MCP Serving: Exposes indexed memories and operational context directly to AI clients (Claude, Cursor, Codex) via Model Context Protocol.

Key Technical Features & Capabilities

High-Performance Architecture: Engineered on top of TypeScript, @ai-sdk/anthropic, @ai-sdk/google, minimizing runtime latency and resource overhead.

Local-First Reliability: Executes core workloads locally on host hardware with zero unexpected external telemetry or cloud vendor lock-in.

Extensible Modularity: Cleanly decoupled module boundaries enable rapid integration, custom scripting, and plugin ecosystem extensibility.

Standardized Developer Tooling: Incorporates automated dependency workflows, reproducible builds, and developer-friendly CLI hooks.

Architecture & Technology Stack

Primary Languages: TypeScript, @ai-sdk/anthropic, @ai-sdk/google

Build Systems & Runtimes: Node.js 20+ / Bun (pnpm / npm / yarn)

Supported Platforms: macOS (Apple Silicon & Intel), Windows 10/11 x64, Linux

System Requirements

Specification	Minimum Requirement	Recommended Specification
Operating System	macOS 12.0+ / Windows 10 x64 / Ubuntu 22.04	macOS 14.0+ Sonoma / Windows 11 x64
Processor Architecture	4-Core x86_64 or Apple Silicon M1	8-Core Apple Silicon / Core i7+
Memory (RAM)	4 GB Unified Memory	16 GB+ High-Speed RAM
Disk Space	1 GB free SSD storage	5 GB+ free SSD storage

Installation & Setup Guide

macOS Installation

Download verified release installer from CookApps or upstream releases.

Drag application package into /Applications.

Windows Installation

Download official setup binary (.exe / .msi).

Run installer and launch from Start Menu.

Building from Source

bash

git clone https://github.com/garrytan/gbrain.git
cd gbrain
pnpm install || npm install
npm run build

How to Use & Workflow

Application Launch: Launch GBrain to initialize runtime state and local storage caches.

Configuration & Workspace: Set up local configuration, environment flags, or CLI paths.

Execution Workflow: Execute automated pipelines or interact through the visual interface.

Data Verification: Review generated outputs stored deterministically in designated directories.

Troubleshooting & Common Issues

Issue: Port or Resource Collision on Startup.

*Cause*: A zombie process or background daemon is holding active port bindings.

*Resolution*: Terminate holding processes before relaunching the application.

Issue: Missing native toolchain dependencies during build.

*Cause*: Host system lacks C++ or platform compilation tools.

*Resolution*: Install Xcode Command Line Tools (macOS) or Visual Studio Build Tools (Windows).

GBrain

Overview

How It Works

Key Technical Features & Capabilities

Architecture & Technology Stack

System Requirements

Installation & Setup Guide

macOS Installation

Windows Installation

Building from Source

How to Use & Workflow

Troubleshooting & Common Issues

How to Use & Getting Started

Ready to run GBrain?

More in ai-automation

CodexClaw

Aside Codemode

AGBrowse