dolabs
v1.0.15
Published
Zero-RAM/GPU Free Terminal AI Agent & DevOps Lab Manual/Generator
Maintainers
Readme
🤖 Robut
Free Terminal DevOps AI Agent & Experiment Manual Engine • Zero RAM/GPU Strain
____ _ _
| _ \ ___ | |__ _ _| |_
| |_) / _ \| '_ \| | | | __|
| _ < (_) | |_) | |_| | |_
|_| \_\___/|_.__/ \__,_|\__|
Free Terminal DevOps AI Agent • Zero RAM/GPU Strain💡 Overview
Robut is an ultra-lightweight, production-ready terminal AI agent and complete DevOps Lab experiment engine purpose-built for low-spec PCs (2GB–4GB RAM, integrated graphics/0% GPU) and students preparing for DevOps Lab exams.
Unlike traditional local AI stacks (e.g., Ollama, vLLM, PyTorch) that demand 8GB–16GB RAM and dedicated GPUs, Robut consumes ~35MB–55MB total process RAM and 0% local GPU by shifting reasoning to 100% free cloud LLM endpoints (Google Gemini 2.5 Flash, Groq Free Tier, OpenRouter Free Models) via direct, lightweight HTTPS REST streaming.
🌟 Key Capabilities
DevOps Lab Experiment Engine (Exp 1 to 10):
- 100% offline manuals, aims, prerequisites, step-by-step procedures, and commands for all 10 syllabus experiments (Git, GitHub, GitFlow, Jenkins, Docker, Maven, Kubernetes).
- Automated starter project & script generation (
robut exp <id> -g). - Comprehensive viva voce exam preparation question bank with model answers (
robut exp <id> --viva).
Zero-RAM/GPU Free Terminal AI Agent:
- Autonomous ReAct reasoning loop with tool calling (file CRUD, safe terminal execution with user confirmation).
- Interactive terminal chat REPL with streaming markdown output and syntax highlighting.
- One-shot task automation (
robut "<prompt>").
Free Fine-Tuning Dataset Generator:
- Single command (
robut finetune:dataset) exportingdevops-finetune.jsonlformatted specifically for Google AI Studio's 100% free fine-tuning platform.
- Single command (
100% Pure JavaScript Architecture:
- Pure ESM (
"type": "module"). - Zero native C++ compilation modules (no Visual Studio or
node-gypneeded). - Fast, resilient offline fallback for all lab manuals and file generators.
- Pure ESM (
🚀 Quick Start
Run Immediately with npx (Recommended)
No installation required. Run directly in any directory:
# Open interactive menu
npx dolabs
# Or generate experiment starter files directly:
npx dolabs exp 8 -gGlobal Installation (Optional)
npm install -g dolabs
robut --helpConfiguration Wizard
Robut includes an interactive setup wizard to configure your free Cloud AI provider and API keys:
robut configThe wizard prompts for:
- Cloud AI Provider: Google Gemini (100% Free, Recommended), Groq Free Tier, or OpenRouter Free.
- API Key: Enter your free Google AI Studio or Groq key (stored securely in
~/.robut/config.json). - Model Selection: Default is
gemini-2.5-flash(with transparent aliasing forgemini-2.0-flashandgemini-1.5-flash). - Offline Preference: Toggle offline-only operation if desired.
Non-Interactive Configuration Commands
# List all settings with masked keys
robut config list
# Get a specific configuration key
robut config get provider
robut config get model
# Update a configuration key
robut config set provider gemini
robut config set model gemini-2.5-flash
robut config set apiKey <your-free-key>
# Reset configuration to defaults
robut config reset🛠️ DevOps Lab Experiments (Exp 1–10)
Robut comes pre-loaded with comprehensive theory, execution guides, automated file generators, and viva voce question banks for all 10 DevOps Lab experiments:
| Exp | Title | Technologies Covered | Generator Output (-g) |
|---|---|---|---|
| 1 | Git Basics & Local Version Control | Git (init, add, commit, diff, log, reset) | Starter Git repository with sample commits |
| 2 | C Programs Library & Branching | C, Git branching (feature/sorting, feature/search) | C-Programs-Library/ with 6 C algorithms, README, .gitignore |
| 3 | GitHub Remote Collaboration & PRs | GitHub (Fork, Clone, Push, Pull Requests) | PR starter repository with code review templates |
| 4 | GitFlow Branching Workflow | GitFlow (develop, feature/*, release/*, hotfix/*) | Branch automation setup script |
| 5 | Jenkins Java CI Pipeline | Jenkins, OpenJDK, Windows Batch (bat) | HelloWorld.java, freestyle build job Jenkinsfile |
| 6 | Jenkins Web App CI/CD | Jenkins, Python Flask | Flask web app CI pipeline (app.py, Jenkinsfile) |
| 7 | Docker Containerization | Docker, Python Flask, Dockerfile, Compose | Dockerfile, app.py, requirements.txt, docker-compose.yml |
| 8 | Jenkins + Docker CI/CD Pipeline | Jenkins Pipeline, Docker daemon | Complete CI/CD Jenkinsfile building and tagging Docker containers |
| 9 | Apache Maven Build Lifecycle | Maven (clean compile test package), JUnit 5 | Maven project structure (pom.xml, App.java, AppTest.java) |
| 10 | Kubernetes Container Orchestration | Kubernetes, Minikube/K8s, Nginx | deployment.yaml (2 replicas), NodePort service.yaml |
Experiment Commands
# List all 10 experiments with syllabus descriptions
robut exp list
# View detailed manual, theory, and procedure for Experiment 2
robut exp 2
# Generate all starter source files and scripts for Experiment 2
robut exp 2 -g
# Generate Docker Flask containerization files for Experiment 7
robut exp 7 --generate --out ./my-docker-app
# Generate Maven & JUnit 5 project for Experiment 9
robut exp 9 -g
# Generate Kubernetes deployment & service YAMLs for Experiment 10
robut exp 10 -g
# Practice viva voce exam questions and model answers
robut exp 2 --viva
robut exp 7 --viva💬 Terminal AI Agent & REPL
Start an interactive chat session:
robut
# or
robut chatSlash Commands in REPL
| Slash Command | Description |
|---|---|
| /help | Display interactive help menu and keyboard shortcuts |
| /exp <id> | View experiment manual directly inside the chat |
| /viva <id> | Practice viva questions for a specific experiment |
| /model | Inspect or switch AI model and provider |
| /status | View live system status (RAM consumption, uptime, backend) |
| /clear | Clear terminal screen and reset conversation history |
| /exit | Exit the REPL session |
One-Shot Automation
Run single tasks directly from the command line:
# Ask questions
robut "Explain the difference between Git merge and Git rebase"
# Autonomous file creation & task execution
robut "Create a Dockerfile for a Node.js 20 Express application on port 3000"🎯 Free Fine-Tuning Dataset Generator
Export a comprehensive dataset ready for Google AI Studio's 100% free model fine-tuning:
robut finetune:datasetOutputs devops-finetune.jsonl with prompt-completion pairs covering:
- Syllabus theory and commands across all 10 experiments
- Boilerplate C, Java, Python, Docker, Jenkins, and Kubernetes templates
- Troubleshooting for common lab errors (Git conflicts, Jenkins build failure, Docker daemon unreachable, Kubernetes CrashLoopBackOff)
- 100+ viva voce examination questions and model answers
🛡️ Zero Native C++ Modules & Low-Spec PC Guarantee
Robut is engineered specifically for university labs and low-spec laptops:
- No C++ Build Tools Required: Pure ECMAScript with zero
node-gypor Visual Studio requirements. - Low Memory Footprint: < 60 MB RSS memory usage.
- Zero Local GPU Usage: 100% of compute runs on Google Cloud TPUs / Groq LPUs.
- Offline Reliability: All experiment guides, code generation, and viva banks work 100% offline without an internet connection.
📄 License
MIT License. Built for students, engineers, and DevOps educators.
