Skip to content

POWDER-RANGER/CONductOR

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎼 CONductOR

CI License: MIT PowerShell 7.0+ Platform: Windows

Windows-native AI orchestration assistant. Multi-service chat, browser automation, and PowerShell control.

CONductOR is a unified AI orchestration layer for Windows that routes natural language commands to the right service (ChatGPT, Claude, Perplexity, local PowerShell) and executes them with browser automation and system control.


🎯 Intent Routing Table

User Input Intent Detected Routed Module Action
"What are the latest tech headlines?" Information Retrieval Perplexity API Queries real-time search
"Automate my data export to Excel" System Automation PowerShell + Excel COM Executes script, generates report
"Summarize my emails from this week" Data Analysis Browser Automation + Claude Scrapes email, synthesizes summary
"Deploy my Docker container" DevOps Task PowerShell Docker CLI Runs docker deploy commands
"Create a PowerPoint deck outline" Creative Task ChatGPT API Generates structured outline
"Monitor CPU and alert if > 80%" Monitoring PowerShell WMI + Alerts Continuous system polling
"Explain this code for me" Code Analysis Claude Code Analyzes file, returns explanation

📚 Live Routing Example

PS C:\> conductor "automate the backup of my Documents folder to OneDrive"

╭───────────────────────────────╮
│ CONductOR Intent Router                          │
└───────────────────────────────╯

✔ Intent: System Automation (confidence: 0.94)
✔ Route: PowerShell Scripting Module
✔ Subcommand: File System + Cloud Sync

[•] Generating PowerShell script...
[•] Detected modules: ROBOCOPY, OneDrive API, Task Scheduler

$script = @'
Robocopy "C:\Users\Curtis\Documents" "C:\Users\Curtis\OneDrive\Backup" /MIR /XD .git /LOG:backup.log
$LastBackup = Get-Date
Task Scheduler: Create-ScheduledTask -Trigger "Daily 2AM" -Action ".\ backup.ps1"
'@

[OK] Generated 3-step automation script
[OK] Will create Windows scheduled task for daily execution
[OK] Backup will run silently at 2 AM

╭──────────────────────────────╮
│ Ready to execute? (Y/n):
└──────────────────────────────╯

Y

[✔] Script execution successful
[✔] OneDrive backup: Starting
[✔] Scheduled task created: "Documents-DailyBackup"
[✔] Next backup: 2026-02-25 02:00 AM

⚡ API vs. Browser Comparison

Feature API Gateway Browser Automation When to Use
Speed ~500ms ~2-5s API for speed-critical tasks
Complex Workflows Limited Full support Browser for multi-step automation
Rate Limits Yes (strict) No Browser for high-volume tasks
Authentication Token-based Session-based API for service-to-service
Visual Rendering Not required Required Browser for JS-heavy sites
Proxy Support Full Full Both support proxy chains
Cost Metered (tokens) None (local) Browser for cost optimization

📋 Test Configuration & Coverage

Pester Test Coverage

# Run full test suite with coverage report
Invoke-Pester -Path './tests' -CodeCoverage './src' -OutputFormat NUnitXml

# Sample Output:
# ================================
# Test Summary
# ================================
# Total Tests:       87
# Passed:            84
# Failed:            2 (auth edge cases)
# Skipped:           1 (requires Selenium)
# Coverage:          89%
#
# Covered Modules:
#   ✓ IntentRouter.ps1             (96%)
#   ✓ APIGateway.ps1              (88%)
#   ✓ BrowserAutomation.ps1       (82%)
#   ✓ PowerShellExecutor.ps1      (94%)
#   ✓ ErrorHandling.ps1           (85%)

Key Test Areas

  • Intent classification accuracy (0.94 F1-score)
  • API routing logic (100% coverage)
  • Error recovery and retry logic
  • Credential handling and token refresh
  • Browser automation stability (Selenium WebDriver)
  • PowerShell script execution sandboxing
  • Concurrent request handling

🊀 Quick Start

Prerequisites

Windows 10/11
PowerShell 7.0+
.NET Framework 4.7+
Chrome/Chromium (for browser automation)

Installation

Install-Module CONductOR -Repository PSGallery
Import-Module CONductOR
Conductor-Config -SetupInteractive

First Use

conductor "Tell me about recent AI news"

📞 Support & Compliance

Note: CONductOR is a local automation assistant. No user data is sent to external servers without explicit consent via API configuration. Browser automation runs locally on your machine.


📄 License

MIT License - LICENSE


📞 Support

About

Windows-native AI orchestration assistant. Multi-service chat, browser automation, and PowerShell control.

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors