Open Gauss Documentation

repository·main·Indexed 22 days ago

https://github.com/math-inc/opengauss

A project-scoped Lean workflow orchestrator and multi-agent interface for lean4-skills workflows. It manages Lean tooling, MCP/LSP wiring, and backend session state to automate proving, formalization, and refactoring tasks. The project includes the gauss-agent (v1.0.0) workspace and integration layers for the Atropos RL training framework, featuring benchmarks such as OpenThoughts-TBLite and YC-Bench.

Tokens
425.9K
Snippets
986
Records
1.6K
Agent score
78%

What's inside Open Gauss

  1. Overview of ASCII Video Skill

    main

    ASCII Video is a skill designed to teach agents how to build single-file Python renderers that convert various inputs (video, audio, images, text, or mathematical functions) into colored ASCII character video.

    Unlike terminal-based ASCII, this produces actual video files (MP4, GIF, or PNG sequences) by computing frames as grids of colored characters composited onto pixel canvases using pre-rasterized font bitmaps. It features a full pipeline including grid systems, effect libraries, shader chains, and audio analysis, all running without a GPU.

  2. Overview of the Pytorch-Fsdp Skill

    main

    The pytorch-fsdp skill provides expert guidance for implementing Fully Sharded Data Parallel (FSDP) training using PyTorch. It covers advanced distributed training techniques including parameter sharding, mixed precision training, CPU offloading, and the FSDP2 API.

    Use this skill when you need to:

    • Implement or debug PyTorch FSDP solutions.
    • Learn best practices for large-scale distributed training.
    • Configure FSDP features like sharding strategies or mixed precision.
    • Work with FSDP2 APIs.
  3. Overview of Bundled Skills in Gauss Agent

    main
    Gauss Agent ships with a built-in library of skills located in ~/.gauss/skills/ upon installation. These skills allow the agent to perform specialized tasks ranging from macOS automation and autonomous AI agent orchestration to GitHub workflow management and ML model evaluation. Skills are organized into functional categories such as apple, autonomous-ai-agents, creative, github, mcp, and mlops.
  4. Overview of the Gauss workflow

    main

    Gauss is a focused Lean workflow workspace designed around managed CLI-agent sessions. Instead of a general agent platform, it provides a narrow, guided experience for Lean 4 development through a specific session lifecycle:

    1. Start the gauss CLI.
    2. Select a specific workflow using a slash command: /prove, /draft, /autoprove, /formalize, or /autoformalize.
    3. Enter the managed Lean session associated with that workflow.
    4. Once the child session exits, Gauss restores the original session state.

    This model allows for specialized environments (like autonomous proving or interactive formalization) while maintaining a consistent user session.

  5. Overview of Gauss Agent Architecture

    main

    Gauss Agent is a modular orchestration engine composed of several specialized subsystems. It has evolved from a simple chat loop into a complex system supporting multiple API modes, auxiliary model routing, ACP editor integration, and RL (Reinforcement Learning) environment infrastructure.

    Key design themes include:

    • Prompt Stability: Ensuring consistent prompt behavior.
    • Observable Tooling: Tool execution must be observable and interruptible.
    • Resilient Persistence: Session state must survive long-running operations.
    • Core/Frontend Separation: Platform frontends (CLI, Gateway, ACP) share a single agent core.
    • Loose Coupling: Optional subsystems are designed to remain decoupled from the core.
  6. Overview of Unsloth features and supported models

    main

    Unsloth is an open-source framework for LLM fine-tuning and reinforcement learning (RL) designed to be 2x faster with 70% less VRAM.

    Key Capabilities

    • Training Modes: Supports full-finetuning, pretraining, and 4-bit, 8-bit, and 16-bit training.
    • Model Support: Supports vision models, text-to-speech (TTS), BERT, and reinforcement learning (RL) using methods like GRPO and GSPO.
    • Hardware Support: Works on Linux, Windows, Colab, Kaggle, and supports NVIDIA, AMD, and Intel GPUs.
    • Accuracy: Uses exact methods with 0% loss in accuracy.
    • Integration: Facilitates exporting models to inference engines like Ollama, llama.cpp, and vLLM.

    Supported Model Families

    Unsloth provides optimized support and bug fixes for models including:

    • gpt-oss
    • Llama (including Llama 4)
    • DeepSeek (including DeepSeek-OCR)
    • Qwen (including Qwen3-VL)
    • Mistral
    • Gemma (Gemma 1–3)
    • Phi-4
  7. Unsloth Documentation Overview

    main

    Unsloth is an open-source framework designed for efficient LLM fine-tuning and reinforcement learning (RL). It provides optimized workflows for training various model architectures, including Llama, Mistral, Gemma, and specialized reasoning models.

    Key capabilities include:

    • Fine-tuning: Support for LoRA, QLoRA, and continued pretraining.
    • Reinforcement Learning: Support for GRPO, DPO, ORPO, and KTO.
    • Quantization: Advanced Dynamic GGUF quants and Quantization-Aware Training (QAT).
    • Multimodal Support: Fine-tuning for Vision/multimodal models (VLM).
    • Deployment: Exporting models to GGUF (for Ollama, llama.cpp), vLLM, and SGLang.
  8. Access Unsloth model catalog on Hugging Face

    main

    Unsloth provides a catalog of models on Hugging Face available in several formats:

    • GGUF: Optimized for running models in tools like Ollama, Open WebUI, and llama.cpp.
    • 4-bit (Instruct): Provided as safetensors, these are suitable for either inference or fine-tuning.
    • 16-bit: Full precision models.
    • Dynamic GGUFs: Specialized GGUF versions available via Unsloth Dynamic 2.0.

    The catalog includes support for major model families such as DeepSeek, Llama, Gemma, Qwen, Mistral, and Phi.

  9. What is LoRA (Low-Rank Adaptation)?

    main
    LoRA is a fine-tuning technique used to optimize Large Language Models (LLMs) efficiently. Instead of updating all the weights in a massive model (e.g., all 70 billion parameters in Llama 70B), LoRA adds two thin matrices, $A$ and $B$, to each weight layer. During training, only these small matrices are optimized, which typically represents only about 1% of the total weights. This significantly reduces the computational resources required for fine-tuning while maintaining performance.
  10. What is migrated during an OpenClaw to Gauss migration?

    main

    The migration process (driven by scripts/openclaw_to_gauss.py) performs the following transformations:

    • SOUL.md: Imports SOUL.md into the Gauss home directory.
    • Memory: Transforms OpenClaw MEMORY.md and USER.md into Gauss memory entries.
    • Command Allowlist: Merges OpenClaw command approval patterns into Gauss command_allowlist.
    • Messaging Settings: Migrates settings like TELEGRAM_ALLOWED_USERS and MESSAGING_CWD.
    • Skills: Copies OpenClaw skills to ~/.gauss/skills/openclaw-imports/.
    • Workspace Assets: Optionally copies workspace instructions and mirrors compatible assets like workspace/tts/ into ~/.gauss/tts/.
    • Secrets: When using the full preset (or --migrate-secrets), it imports allowlisted secrets such as TELEGRAM_BOT_TOKEN.
    • Archiving: Non-secret documents without a direct Gauss destination are archived for manual review.
  11. What is GRPO and when to use it

    main

    Group Relative Policy Optimization (GRPO) is a reinforcement learning algorithm used for fine-tuning language models. Unlike PPO, GRPO does not require a separate reward model; instead, it generates a group of completions for each prompt (typically 4-16) and compares their rewards within that group to update the policy.

    Use GRPO when you need to:

    • Enforce specific output formats (XML, JSON, structured reasoning).
    • Teach verifiable tasks with objective metrics (math, coding, fact-checking).
    • Improve reasoning via chain-of-thought rewards.
    • Align models to domain-specific behaviors without preference pairs.
    • Optimize for multiple objectives (format + correctness + style).

    Do NOT use GRPO for:

    • Simple supervised fine-tuning (use SFT).
    • Tasks without clear reward signals.
    • When you already have high-quality preference pairs (use DPO/PPO).