Skip to content

nzer8/workflow-orchestrator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 

Repository files navigation

Agentic Workflow Orchestrator: The Autonomous Task Execution Engine for AI-Driven Development

Download

Version 1.0.0 | Released 2026 | MIT License

🚀 What Is This?

Imagine your issue tracker transforming into a living, breathing command center—where every ticket, bug report, or feature request becomes a mission brief for an autonomous AI agent. That's the core philosophy behind Agentic Workflow Orchestrator. It doesn't just manage tasks; it executes them. It dispatches work across a swarm of LLM providers, spins up secure runtimes, collects evidence of completion, and closes the loop between human intention and machine action. This is the missing execution layer for agentic engineering—turning chaotic development workflows into a synchronized orchestra of AI-driven productivity.

🔍 The Problem We Solve

Traditional issue trackers are passive. They store information but don't act on it. Developers spend hours triaging, assigning, and reviewing. Meanwhile, AI agents are powerful but disconnected from the operational reality of your project. Agentic Workflow Orchestrator bridges that gap. It listens to your tracker, interprets context, and autonomously executes tasks—from code generation to test execution to documentation updates. Your issue tracker graduates from a database to a dispatch system.

💡 Key Benefits

  • Autonomous Task Execution: No more manual handoffs. Agents pick up issues, execute them, and report back with evidence.
  • Multi-Provider Coordination: Seamlessly routes work to OpenAI, Claude, or local models based on task complexity and cost.
  • Runtime Isolation: Each task runs in a sandboxed environment, preventing side effects and ensuring reproducibility.
  • Evidence Tracking: Every completed task generates a trail of artifacts—code diffs, logs, screenshots, or test results.
  • Human-in-the-Loop Optional: Approve, reject, or modify agent outputs before they merge into the main branch.

📊 How It Works (Architecture Diagram)

graph TD
    A[Issue Tracker] -->|New Issue| B(Orchestrator Core)
    B --> C{Task Classifier}
    C -->|Code Generation| D[OpenAI Agent]
    C -->|Bug Fix| E[Claude Agent]
    C -->|Documentation| F[Local LLM Agent]
    C -->|Testing| G[Specialized Runtime]
    D --> H[Evidence Collector]
    E --> H
    F --> H
    G --> H
    H --> I[Output Queue]
    I --> J[PR/Merge Request]
    I --> K[Issue Update with Evidence]
    J --> L[Code Review]
    K --> M[Human Approval]
    L --> M
    M --> N[Deployment]
Loading

🧩 Example Profile Configuration

Below is a sample configuration file that defines how your agents behave, which providers they use, and what runtimes they require. This is the brain of your orchestrator.

profile:
  name: "default-dev-profile"
  version: "2026.1"
  
  agents:
    code_writer:
      provider: "openai"
      model: "gpt-4-turbo"
      temperature: 0.3
      max_tokens: 4096
      runtime: "python-3.12-sandbox"
      context_window: 128000
      tools:
        - "code_search"
        - "file_write"
        - "git_commit"
    
    bug_fixer:
      provider: "claude"
      model: "claude-3-opus-20240229"
      temperature: 0.1
      max_tokens: 8192
      runtime: "debug-container"
      context_window: 200000
      tools:
        - "stack_trace_analysis"
        - "unit_test_runner"
        - "diff_generator"
    
    documenter:
      provider: "local"
      model: "llama-3.1-70b"
      temperature: 0.5
      max_tokens: 2048
      runtime: "standard-node"
      context_window: 32000
      tools:
        - "markdown_generator"
        - "api_spec_parser"
        - "readme_updater"
  
  orchestration:
    max_retries: 3
    timeout_seconds: 600
    evidence_format: "json+zip"
    human_approval_required: false
    parallel_execution: true

🖥️ Example Console Invocation

Start an agentic workflow directly from your terminal. This command dispatches all open issues labeled "code" to your configured agents.

orchestrator dispatch \
  --repo "my-org/awesome-project" \
  --label "code" \
  --profile "default-dev-profile" \
  --output "./evidence" \
  --auto-approve \
  --verbose

Expected output:

[2026-03-15 10:23:01] 🔄 Starting dispatch for label: "code"
[2026-03-15 10:23:02] ✅ Found 3 matching issues
[2026-03-15 10:23:03] 📤 Issue #42 dispatched to OpenAI agent
[2026-03-15 10:23:04] 📤 Issue #89 dispatched to Claude agent
[2026-03-15 10:23:05] 📤 Issue #101 dispatched to local agent
[2026-03-15 10:23:06] ⏳ Waiting for results...
[2026-03-15 10:25:12] ✅ Issue #42 completed | Evidence: ./evidence/20260315-code-42.zip
[2026-03-15 10:25:14] ✅ Issue #89 completed | Evidence: ./evidence/20260315-code-89.zip
[2026-03-15 10:25:30] ✅ Issue #101 completed | Evidence: ./evidence/20260315-code-101.zip
[2026-03-15 10:25:31] 🚀 All tasks resolved. PRs created: PR #203, PR #204, PR #205

💻 Operating System Compatibility

OS Status Notes
🐧 Linux (Ubuntu 22.04+) ✅ Fully Supported Production-grade runtime
🍎 macOS (Ventura+) ✅ Fully Supported Docker Desktop required for sandboxing
🪟 Windows 11 ✅ Supported WSL2 recommended for native performance
🐧 Linux (Debian 11+) ✅ Supported Some features require kernel 5.15+
🍏 macOS (Monterey) ⚠️ Limited No GPU acceleration for local models
🪟 Windows 10 ⚠️ Limited Requires Hyper-V enabled

✨ Feature List

  • Autonomous Issue Resolution: Agents convert tickets into executable tasks without human intervention.
  • Multi-Model Orchestration: Dynamically routes tasks to OpenAI, Claude, Anthropic, or local models based on profile rules.
  • Sandboxed Runtimes: Every agent action occurs in an isolated container—no risk to your production environment.
  • Evidence Pipeline: Collects logs, diffs, screenshots, and test results as proof of completion.
  • Responsive UI Dashboard: Monitor agent activity, review evidence, and approve outputs from a web interface.
  • Multilingual Support: Agents understand and generate code in Python, JavaScript, Rust, Go, Java, TypeScript, and 15+ other languages.
  • 24/7 Customer Support: Built-in escalation logic—if an agent fails after retries, it notifies your team via Slack or email.
  • Webhook Integration: Connects to GitHub, GitLab, Jira, Linear, and custom webhook endpoints.
  • Cost Optimization Dashboard: Tracks token usage and runtime costs per provider, per agent, per task.
  • Audit Logging: Immutable log of every decision, action, and output for compliance and debugging.

🔗 Integration with OpenAI API and Claude API

The orchestrator deeply integrates with both OpenAI and Claude APIs, leveraging their unique strengths for different task types.

OpenAI API Integration

  • Endpoint: https://api.openai.com/v1/chat/completions
  • Capabilities: Code generation, natural language understanding, structured data extraction.
  • Configuration: Set OPENAI_API_KEY environment variable or specify in your profile.
  • Optimization: Automatically adjusts temperature and max_tokens based on task type in your profile.
  • Fallback Mechanism: If rate-limited, the orchestrator queues and retries with exponential backoff.

Claude API Integration

  • Endpoint: https://api.anthropic.com/v1/messages
  • Capabilities: Detailed analysis, long-context reasoning, complex debugging.
  • Configuration: Set ANTHROPIC_API_KEY environment variable or specify in your profile.
  • Optimization: Uses Claude's 200k token context window for large codebase understanding.
  • Fallback Mechanism: Tasks requiring high precision are automatically routed to Claude when OpenAI fails.

🌐 Responsive UI and Dashboard

The web-based dashboard is built with modern reactive frameworks (React 19 + Tailwind CSS 4). It adapts to any screen size—from a 4K monitor to a tablet held by a field engineer. Real-time WebSocket updates show agent progress as it happens. The UI is fully internationalized, supporting English, Spanish, French, German, Japanese, and Mandarin out of the box.

🛡️ Security and Isolation

Each agent runtime is isolated using gVisor or Firecracker microVMs, depending on the host OS. Network access is restricted by default—agents can only reach whitelisted APIs (your tracker, your git host). All evidence is checksummed and signed before storage, ensuring tamper-proof audit trails.

💼 Use Cases in 2026

  • Startups: Automate bug triage and hotfix generation during crunch times.
  • Enterprise: Standardize code review and documentation across distributed teams.
  • Open Source Maintainers: Let agents handle repetitive issues while humans focus on architecture.
  • DevOps: Auto-generate CI/CD pipeline fixes from failure logs.
  • Education: Provide students with AI teaching assistants that submit code for review.

📜 License

This project is distributed under the MIT License. You are free to use, modify, and distribute this software for any purpose, including commercial applications. See the LICENSE file for the full text.

⚠️ Disclaimer

Important: Agentic Workflow Orchestrator is a powerful tool designed to automate development tasks. However, it is not a replacement for human judgment. Always review agent-generated code and decisions before deploying to production. The creators and contributors assume no liability for any damages, data loss, or security breaches resulting from the use of this software. By downloading and using this orchestrator, you acknowledge that you are responsible for the actions taken by the agents you configure. Use at your own risk.

This project is not affiliated with OpenAI, Anthropic, or any other listed provider. All trademarks are property of their respective owners.

📥 Get Started Today

Download

System Requirements:

  • Docker 24+ or Podman 4+
  • Python 3.11+ or Node.js 20+
  • 8GB RAM minimum (16GB recommended for local models)
  • 20GB free disk space for sandbox images

Quick Start:

  1. Download the binary or container image from the link above.
  2. Create a orchestrator.yml profile file using the example above.
  3. Set your API keys as environment variables or in a .env file.
  4. Run orchestrator start to launch the daemon and dashboard.
  5. Connect your issue tracker via webhook.
  6. Watch as your issues are autonomously resolved.

Agentic Workflow Orchestrator—turning passive issue trackers into autonomous execution engines since 2026.