Helper Bot – Nimno

Helper Bot is a free, open-source AI assistant designed to help people learn web development and start earning in the tech field, regardless of their financial situation or access to banking. It bridges the gap between free web-based AI chatbots and local development work by enabling file transfer and automation.

Mission

This project aims to empower people in underserved communities (especially in the third world) who lack access to banking services and financial resources to use AI for learning development and building income-generating skills. By leveraging free AI tiers and creating tools that work without API keys or paid services, we provide a pathway to tech literacy and economic opportunity.

How It Works

Helper Bot uses a revolutionary hybrid AI architecture that combines the intelligence of advanced AI with the accessibility of free services:

The “AI Backbone” Design

Decision Engine (Google Antigravity):

Free during public preview (individual tier $0/month)
Access to Gemini 3 Pro, Claude Sonnet 4.5, and GPT models
Acts as the “brain” that decides how to handle each request
Classifies requests, selects best providers, manages file operations

Execution Layer (Helper Bot):

Browser automation via Playwright + Browser-Use
File system access (read/write local files)
Multi-provider support (free web AI + optional paid APIs)
VS Code-style interface for comfortable development

The Complete Flow

Your Request → Antigravity (Decision) → Helper Bot (Execution) → Result
                                    ↓
    ┌─ Simple Question → DuckDuckGo AI → Direct Response
    ├─ Code Debugging → Include Files → Gemini → Extract & Update  
    ├─ Complex Task → Claude API → Structured Response
    └─ Meta Decision → Antigravity chooses → Execute Plan

Smart Request Processing

Antigravity analyzes each request and decides:

What type of request is this? (simple, context, complex, meta)
Which AI provider is best suited? (free vs paid)
What files are needed for context?
How should the response be processed?

Helper Bot executes the plan:

Automatically includes relevant files when needed
Extracts code from AI responses using structured prompts
Updates local files with user confirmation
Switches providers seamlessly for optimal results

Why This Architecture is Game-Changing

Free Tier Power:

Antigravity’s decision engine: Free (preview)
Web AI providers: Free (DuckDuckGo, Gemini, HuggingFace)
Full functionality without any costs

Premium Options:

Optional API keys for OpenAI, Anthropic when needed
Antigravity intelligently chooses free vs paid providers
Users only pay when they need extra capabilities

The Best of Both Worlds:

Intelligence of advanced AI (decision making)
Accessibility of free services (no barriers to entry)
Flexibility to scale up when needed

Intelligent Request Handling

The hybrid architecture solves the request classification problem elegantly:

Antigravity-Powered Decision Making

Instead of fragile pattern matching, Antigravity’s AI analyzes each request:

User: "My app shows 404 error"
Antigravity Response: {
    "request_type": "diagnostic",
    "needed_files": ["routes.js", "index.html", "server.js"],
    "best_provider": "gemini",
    "processing_strategy": "include_context + extract_fix"
}

Smart Execution Strategies

Simple Questions (Direct Relay):

“Explain this JavaScript function”
“What does CSS flexbox do?”
Action: Send directly to DuckDuckGo AI → Return response

Context-Dependent (File Analysis):

“What’s wrong with my app?”
“Fix this broken CSS”
Action: Antigravity identifies relevant files → Include with prompt → Extract solution

Complex Tasks (Multi-Step):

“Build a todo app from scratch”
“Optimize this database query”
Action: Antigravity creates plan → Execute step-by-step → Validate results

Meta Decisions (AI-Assisted Choices):

“Should I use React or Vue?”
“What’s the best approach for this project?”
Action: Antigravity researches options → Makes recommendation → Executes implementation

Structured Response Processing

The File Update Problem Solved:
Antigravity trains other AI providers to respond in structured format:

System Prompt to AI:
"You are HelperBot. When providing code updates, ALWAYS use:
HELPERBOT_UPDATE_FILE: filename.ext

language
complete code here

HELPERBOT_END_UPDATE
Then explain your changes."

Reliable Extraction:

Primary: Look for structured format (80-90% success rate)
Fallback: Smart parsing with user confirmation
Never overwrite files without explicit approval

Features

AI-Powered Decision Engine: Google Antigravity analyzes requests and chooses optimal strategies
Hybrid Provider System: Free web AI (DuckDuckGo, Gemini, HuggingFace) + optional paid APIs
Intelligent File Management: Automatic code extraction and structured file updates
VS Code-Style Interface: Familiar file explorer + code editor for comfortable development
Hidden Browser Automation: Seamless interaction with AI services – no browser windows needed
Smart Context Inclusion: Automatically includes relevant files when AI needs context
Structured Response Training: AI providers trained to respond in predictable formats
Multi-Provider Intelligence: Antigravity selects the best AI for each specific task
Free-First Design: Full functionality without API keys or payments
Scalable Architecture: Add premium capabilities when needed, not required

AI Provider Ecosystem

Free Tier (Core Experience)

Google Antigravity – Decision Engine

Cost: Free (public preview)
Models: Gemini 3 Pro, Claude Sonnet 4.5, GPT-OSS
Role: Request analysis, provider selection, file management

Web AI Providers – Execution

Arena AI – ⭐ GAME CHANGER – 50+ frontier models (Claude Opus 4.5, GPT-5.2, Grok 4.1) for FREE via research platform
DuckDuckGo AI: Quick questions, general assistance (no login)
Google Gemini: Complex reasoning, multi-step problems (Google account)
DeepSeek: Coding-focused, technical problems (email signup)
Kimi: Long context, large file analysis (email signup)
Mistral Chat: Multilingual tasks, European languages (email signup)
Qwen Chat: Chinese/English coding, technical tasks (email signup)
OpenRouter: Model variety, premium access via credits (email signup)
Venice AI: Privacy-focused conversations ❌ MOVED TO PAID MODEL

Premium Options (Enhanced Capabilities)

API Providers – When you need extra power

OpenAI GPT-4: Advanced coding, complex algorithms
Anthropic Claude: Large codebases, detailed explanations
Local Models: Ollama for offline processing

Provider Specialization

Best Use Cases by Provider:

Premium Tasks: Arena AI (Claude Opus 4.5, GPT-5.2 – normally $20-100/month, now FREE)
Simple Questions: DuckDuckGo AI (no login required)
Coding Problems: Arena AI (Claude Opus 4.5), DeepSeek, Qwen Chat (coding-optimized)
Large Files: Kimi (200K context window), Arena AI (advanced models)
Complex Reasoning: Arena AI (GPT-5.2, Claude Opus 4.5), Gemini (multi-step analysis)
Real-time Data: Grok (current information)
Model Comparison: Arena AI (side-by-side model battles), OpenRouter (access to multiple models)
Research & Development: Arena AI (cutting-edge models before public release)

User Preferences & Authentication

Provider Selection Strategy

Automatic Selection (Default):

Antigravity chooses optimal provider based on task type
Rotates providers to avoid rate limits
Falls back to alternatives if primary provider unavailable

User Preferences (Optional):

⭐ Arena AI         (Premium models FREE - TOP CHOICE)
✅ DuckDuckGo AI    (Always available)
✅ Google Gemini    (Signed in)
✅ DeepSeek         (Signed in)
✅ Kimi             (Signed in)
❌ Grok             (No X account)
⚠️ Claude           (Usage limit reached - use Arena AI instead)

Priority Ordering:

Arena AI (premium models, free access) – PRIMARY CHOICE
User-preferred providers (if Arena unavailable)
Task-optimized providers (Antigravity selection from Arena’s 50+ models)
Backup providers (if Arena limits reached)
Free alternatives (before paid options)

Authentication Strategy

Security-First Approach:

Initial Signup: Users sign up in normal browser with their own credentials
Session Import: Helper Bot imports existing cookies/sessions securely
Local Storage: Login credentials stored locally (never transmitted)
Provider Switching: Seamless switching between logged-in services

Browser Session Management:

User's Browser → Create Account → Helper Bot Import Session
                                                    ↓
Helper Bot → Isolated Browser Profile → Provider Access

Privacy Protection:

Each provider gets isolated browser profile
Credentials never leave user’s machine
Sessions persist between Helper Bot restarts
Users control which providers to connect

Configuration Example

{
  "user_preferences": {
    "enabled_providers": [
      "arena_ai",
      "duckduckgo",
      "gemini", 
      "deepseek",
      "kimi"
    ],
    "provider_priority": {
      "premium_tasks": ["arena_ai"],
      "coding": ["arena_ai", "deepseek", "qwen"],
      "questions": ["duckduckgo", "arena_ai"],
      "large_files": ["arena_ai", "kimi"],
      "realtime": ["grok", "arena_ai"],
      "research": ["arena_ai"]
    },
    "arena_settings": {
      "auto_select": true,
      "prefer_ranked": true,
      "use_battle_data": true,
      "fallback_mode": "direct"
    },
    "auto_rotate": true,
    "respect_limits": true,
    "prefer_arena": true
  },
  "authentication": {
    "import_sessions": true,
    "isolated_profiles": true,
    "local_storage_only": true
  }
}

The Arena AI Advantage

Access to Premium Models – FREE

Normally Paid Models (Now Free via Arena):

Claude Opus 4.5: $20/month value
GPT-5.2: Not publicly available (future premium)
Grok 4.1: X Premium required
Gemini 3 Pro Advanced: Google One subscription
50+ other frontier models: Various premium costs

Arena’s Intelligent Modes

Battle Mode (Anonymous Comparison):

Models compete anonymously for fair comparison
Community voting determines rankings
Pre-release models tested before public release

Side-by-Side Mode:

Direct comparison of specific models
Non-anonymous voting
Good for targeted model selection

Direct Mode (Helper Bot Integration):

Interact with specific models directly
No voting, focused on task completion
Perfect for automated workflows

Auto-Select Mode:

Arena automatically selects optimal models based on task
Uses community ranking data
Complementary to Antigravity’s decision engine

Hybrid Intelligence Strategy

Antigravity + Arena Auto-Select:

User Request → Antigravity (Task Analysis) → Arena Auto-Select (Model Choice) → Execution
                                    ↓
    ┌─ Simple Question → Arena selects DuckDuckGo-equivalent → Direct response
    ├─ Coding Task → Arena selects Claude Opus 4.5 → Premium quality
    ├─ Research → Arena selects GPT-5.2 → Cutting-edge capability
    └─ Complex Problem → Arena selects top-ranked model → Optimal result

Dual Decision Engine Benefits:

Antigravity: Contextual analysis, file management, provider routing
Arena: Model performance data, real-time rankings, specialized selection
Combined: Perfect task + perfect model = optimal results

Project Structure

helperbot/
├── core/                 # Core architecture
│   ├── decision_engine.py    # Antigravity integration
│   ├── request_router.py     # Request classification & routing
│   ├── file_manager.py       # Smart file operations
│   └── response_parser.py    # Structured response extraction
├── providers/           # AI provider implementations
│   ├── __init__.py      # Provider registry and factory
│   ├── base.py          # Abstract base class for providers
│   ├── api_provider.py  # OpenAI, Anthropic API support
│   ├── web_provider.py  # DuckDuckGo, Gemini, HuggingFace
│   ├── antigravity.py   # Google Antigravity integration
│   └── local_provider.py # Ollama support
├── automation/          # Browser automation
│   ├── browser_controller.py  # Playwright + Browser-Use
│   ├── file_extractor.py     # Code extraction from web pages
│   └── response_formatter.py  # Structured prompt formatting
├── ui/                  # User interface
│   ├── vscode_interface/     # VS Code-style editor
│   ├── chat_panel.py         # Chat interface
│   └── file_explorer.py       # File management UI
├── config.py            # Configuration management
├── config.json.example  # Example configuration template
├── database.py          # SQLite persistence
├── server.py            # Main server (aiohttp + WebSockets)
├── run.py               # Entry point script
└── requirements.txt     # Python dependencies

Getting Started

Quick Start (Free Tier)

Download: Get the latest release or clone this repository
Install Dependencies:

   pip install -r requirements.txt

Configure Antigravity (Free):

Sign up for Google Antigravity (free during preview)
Add your Antigravity credentials to config.json

Run:

   python3 run.py

Start Coding: Open VS Code-style interface and begin chatting

Premium Setup (Optional)

Add API keys for enhanced capabilities:

{
  "antigravity": {
    "enabled": true,
    "api_key": "your_antigravity_key"
  },
  "providers": {
    "openai": {
      "api_key": "your_openai_key",  // Optional
      "enabled": false
    },
    "anthropic": {
      "api_key": "your_anthropic_key",  // Optional
      "enabled": false
    }
  }
}

System Requirements

Python 3.8+ (for modern automation libraries)
4GB RAM minimum (browser automation requires more memory)
Modern browser (Chrome/Chromium for automation)
Internet connection (for AI services)
Google Antigravity account (free signup)

Free AI Providers

Helper Bot supports several free AI services that don’t require API keys or payments:

DuckDuckGo AI Chat

Cost: Completely free
Requirements: None
Models: GPT-3.5, Claude Instant
Best for: Quick questions, coding help, general assistance

Google Gemini

Cost: Free tier available
Requirements: Google account
Models: Gemini Pro
Best for: Complex reasoning, multi-step problems

HuggingFace Chat

Cost: Free tier available
Requirements: HuggingFace account (optional)
Models: Mixtral, Llama-2, and more
Best for: Specialized tasks, different model perspectives

Adding More Providers

The modular design makes it easy to add new free AI services. See providers/web_provider.py for examples.

Use Cases for Learning

Web Development

Create and modify HTML/CSS files
Get help with JavaScript debugging
Build portfolio projects step-by-step

Python Programming

Write and test Python scripts
Learn data structures and algorithms
Build simple applications and tools

General Learning

Get explanations of technical concepts
Practice problem-solving with AI guidance
Build confidence through hands-on projects

Current Status & Development Roadmap

Completed Architecture

[x] Hybrid AI Architecture Design: Antigravity decision engine + multi-provider execution
[x] Provider Abstraction Layer: Support for web AI, API AI, and local models
[x] Browser Automation Strategy: Playwright + Browser-Use integration plan
[x] Structured Response System: Reliable file update extraction method
[x] VS Code Interface Design: Familiar development environment

Phase 1: Core Implementation (Next Steps)

[ ] Antigravity Integration: Decision engine for request classification
[ ] Browser Automation: Playwright-based web AI interaction
[ ] File Management System: Smart context inclusion and updates
[ ] Response Parser: Structured extraction with fallback handling
[ ] Basic UI: VS Code-style interface with chat panel

Phase 2: Enhanced Capabilities

[ ] Multi-Provider Intelligence: Automatic provider selection
[ ] Project Templates: Starter projects for learning
[ ] Tutorial Mode: Guided lessons for beginners
[ ] Context Memory: Conversation history and file awareness

Phase 3: Advanced Features

[ ] Premium API Integration: OpenAI, Anthropic for power users
[ ] Offline Mode: Local AI with Ollama
[ ] Community Features: Project sharing and collaboration
[ ] Mobile Support: Cross-platform compatibility

Technical Milestones

[ ] MVP: Free-tier functionality with Antigravity + web AI
[ ] Beta: Premium options + advanced features
[ ] v1.0: Stable release with full ecosystem
[ ] Enterprise: Team features and advanced automation

Comparison with Existing Tools

Feature	Helper Bot	Claude Code	OpenClaw
Free Tier	✅ Full functionality + PREMIUM models FREE	❌ Paid only	❌ Paid only
Decision Engine	✅ Antigravity AI	❌ Manual	❌ Manual
Premium Models	✅ Claude Opus 4.5, GPT-5.2 FREE via Arena	❌ Claude only	❌ API only
Multi-Provider	✅ 50+ models via Arena + 8+ others	❌ Claude only	❌ API only
File Automation	✅ Smart extraction	✅ Direct API	✅ Direct API
Browser Automation	✅ Hidden automation	✅ Extension	✅ CDP Control
Cost Model	Free-first with premium capabilities	Premium	Premium

Helper Bot uniquely combines free accessibility with premium AI capabilities – something no other tool currently offers. Users get access to models that normally cost hundreds of dollars per month, completely free!

License

MIT