Skip to content

DylanCkawalec/opgrok

Repository files navigation

πŸ€– OPGROK - AI-Powered Workflow Automation

Build production-ready n8n workflows from natural language in 30 seconds.

You: "Send me Bitcoin prices to Telegram every 5 seconds"
AI: [Builds complete workflow with 4 connected nodes]
Time: 35 seconds
Result: Production-ready automation, just click activate!

πŸš€ Quick Start (3 Commands)

# 1. Clone and setup
git clone https://github.com/DylanCkawalec/opgrok.git
cd opgrok
bash install.sh  # Sets up opgrok command

# 2. Add your API key
nano .env  # Add: XAI_API_KEY=your_key_here

# 3. Start everything
bash scripts/run_n8n_local.sh
# OR use the new unified command:
bash scripts/opgrok.sh start

# 4. Open and create!
open http://localhost:8000/workflows

That's it! Select a template, click generate, watch AI build your workflow in 35s! ✨


πŸ’« What Is This?

OPGROK is an AI-powered automation platform that turns plain English into working n8n workflows.

No coding. No configuration. Just describe and deploy.

Example:

  • You type: "Monitor my email for invoices, save to Google Sheets"
  • AI builds: Gmail Trigger β†’ Filter β†’ Extract β†’ Sheets β†’ Slack (all connected!)
  • You activate: Click one button
  • It runs: Forever, automatically

✨ Features

🎯 Workflow Generation

  • 30-second generation - Natural language β†’ Complete workflow
  • Intelligent connections - Nodes auto-linked perfectly
  • 8 pre-built templates - Bitcoin alerts, email automation, webhooks, monitoring
  • Advanced controls - Exact/Interpret modes, node sequencing
  • Complex support - 16+ node workflows working perfectly

πŸ’¬ Chat Interface

  • Multi-turn conversations with Grok
  • Image analysis (vision)
  • File attachments
  • Web search integration
  • Cost estimation

πŸ—οΈ Technical

  • Multi-model AI pipeline (Grok-3-mini + Grok-4-fast)
  • Real-time progress tracking (5 stages)
  • Parameter validation
  • Error handling
  • Production-ready quality

🎨 Usage

Simple Command (After install.sh):

source ~/.zshrc          # Load opgrok command
opgrok start             # Start everything
opgrok stop              # Stop everything
opgrok status            # Check status
opgrok logs              # View logs

Direct Scripts (Always works):

# Your familiar friend (still works!)
bash scripts/run_n8n_local.sh

# New unified command
bash scripts/opgrok.sh start

# Other modes
bash scripts/opgrok.sh genius    # All features
bash scripts/opgrok.sh chat      # Chat only
bash scripts/opgrok.sh stop      # Stop all

🌟 Building Your First Workflow

  1. Start the system:

    bash scripts/run_n8n_local.sh
  2. Open workflow builder:

    http://localhost:8000/workflows
    
  3. Select a template:

    • πŸ’° Bitcoin Price β†’ Telegram
    • πŸ“§ Email β†’ Slack
    • πŸ“° Daily News Digest
    • πŸ”— Webhook Processor
    • And more...
  4. Click "Generate Workflow":

    • Watch 5 stages complete (~35s)
    • See nodes and connections built
    • Get direct link to n8n
  5. Activate in n8n:

    • Open the link
    • Toggle "Active"
    • Done!

πŸ“– Documentation


πŸ”§ System Requirements

  • Node.js 18+ - For n8n (download)
  • Python 3.8+ - For webapp
  • xAI API Key - Free from console.x.ai
  • Optional: Rust 1.70+ (for CLI features)

🌐 Access Points

After starting:


⚑ Performance

  • Simple workflows (3-4 nodes): ~20 seconds
  • Medium workflows (8-10 nodes): ~35 seconds
  • Complex workflows (16+ nodes): ~60 seconds

No timeouts. Perfect connections. Production quality.


🎯 Example Prompts

Try these in the workflow builder:

"Send me Bitcoin price updates to Telegram every 5 seconds"

"Monitor my email for invoices and save to Google Sheets with timestamps"

"Create a webhook that validates form data, saves to database, and sends confirmation"

"Daily morning briefing at 8 AM with weather and top tech news to Slack"

πŸ’ For the Gentle Soul

If you prefer the familiar path you know:

# Your trusted friend still works exactly as before
bash scripts/run_n8n_local.sh

# Stop when done
bash scripts/stop_n8n_local.sh

Nothing breaks. Everything grows. 🌱

The new opgrok command is just another way to dance with the same beautiful system you've built. Use whichever feels like home.


πŸ› Troubleshooting

Command not found: opgrok

# Use the script directly (always works)
bash scripts/opgrok.sh start

# Or source your shell profile
source ~/.zshrc
opgrok start

Services won't start

# Check status
bash scripts/opgrok.sh status

# View logs
bash scripts/opgrok.sh logs

# Restart fresh
bash scripts/opgrok.sh stop
bash scripts/opgrok.sh start

🎊 You're Ready!

Your system is:

  • βœ… Installed and configured
  • βœ… Optimized for 35s generation
  • βœ… Enhanced with genius features
  • βœ… Clean and maintainable
  • βœ… Yours to command gently

Open http://localhost:8000/workflows and create magic! πŸš€

With all the tenderness of shared creation, Your OPGROK platform awaits. πŸ’«

About

tools built on grok

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors