You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
swarms/swarms/cli/main.py

419 lines
15 KiB

This file contains invisible Unicode characters!

This file contains invisible Unicode characters that may be processed differently from what appears below. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to reveal hidden characters.

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

import argparse
import os
import time
import webbrowser
from rich.console import Console
from rich.panel import Panel
from rich.progress import Progress, SpinnerColumn, TextColumn
from rich.table import Table
from rich.text import Text
from swarms.agents.auto_generate_swarm_config import (
generate_swarm_config,
)
from swarms.agents.create_agents_from_yaml import (
create_agents_from_yaml,
)
from swarms.cli.onboarding_process import OnboardingProcess
from swarms.utils.formatter import formatter
# Initialize console with custom styling
console = Console()
class SwarmCLIError(Exception):
"""Custom exception for Swarm CLI errors"""
pass
# Color scheme
COLORS = {
"primary": "red",
"secondary": "#FF6B6B",
"accent": "#4A90E2",
"success": "#2ECC71",
"warning": "#F1C40F",
"error": "#E74C3C",
"text": "#FFFFFF",
}
ASCII_ART = """
▄████████ ▄█ █▄ ▄████████ ▄████████ ▄▄▄▄███▄▄▄▄ ▄████████
███ ███ ███ ███ ███ ███ ███ ███ ▄██▀▀▀███▀▀▀██▄ ███ ███
███ █▀ ███ ███ ███ ███ ███ ███ ███ ███ ███ ███ █▀
███ ███ ███ ███ ███ ▄███▄▄▄▄██▀ ███ ███ ███ ███
▀███████████ ███ ███ ▀███████████ ▀▀███▀▀▀▀▀ ███ ███ ███ ▀███████████
███ ███ ███ ███ ███ ▀███████████ ███ ███ ███ ███
▄█ ███ ███ ▄█▄ ███ ███ ███ ███ ███ ███ ███ ███ ▄█ ███
▄████████▀ ▀███▀███▀ ███ █▀ ███ ███ ▀█ ███ █▀ ▄████████▀
███ ███
"""
def create_spinner(text: str) -> Progress:
"""Create a custom spinner with the given text."""
return Progress(
SpinnerColumn(style=COLORS["primary"]),
TextColumn("[{task.description}]", style=COLORS["text"]),
console=console,
)
def show_ascii_art():
"""Display the ASCII art with a glowing effect."""
panel = Panel(
Text(ASCII_ART, style=f"bold {COLORS['primary']}"),
border_style=COLORS["secondary"],
title="[bold]Welcome to Swarms[/bold]",
subtitle="[dim]Power to the Swarms[/dim]",
)
console.print(panel)
def create_command_table() -> Table:
"""Create a beautifully formatted table of commands."""
table = Table(
show_header=True,
header_style=f"bold {COLORS['primary']}",
border_style=COLORS["secondary"],
title="Available Commands",
padding=(0, 2),
)
table.add_column("Command", style="bold white")
table.add_column("Description", style="dim white")
commands = [
("onboarding", "Start the interactive onboarding process"),
("help", "Display this help message"),
("get-api-key", "Retrieve your API key from the platform"),
("check-login", "Verify login status and initialize cache"),
("run-agents", "Execute agents from your YAML configuration"),
("auto-upgrade", "Update Swarms to the latest version"),
("book-call", "Schedule a strategy session with our team"),
("autoswarm", "Generate and execute an autonomous swarm"),
]
for cmd, desc in commands:
table.add_row(cmd, desc)
return table
def show_help():
"""Display a beautifully formatted help message."""
console.print(
"\n[bold]Swarms CLI - Command Reference[/bold]\n",
style=COLORS["primary"],
)
console.print(create_command_table())
console.print(
"\n[dim]For detailed documentation, visit: https://docs.swarms.world[/dim]"
)
def show_error(message: str, help_text: str = None):
"""Display error message in a formatted panel"""
error_panel = Panel(
f"[bold red]{message}[/bold red]",
title="Error",
border_style="red",
)
console.print(error_panel)
if help_text:
console.print(f"\n[yellow] {help_text}[/yellow]")
def execute_with_spinner(action: callable, text: str) -> None:
"""Execute an action with a spinner animation."""
with create_spinner(text) as progress:
task = progress.add_task(text, total=None)
result = action()
progress.remove_task(task)
return result
def get_api_key():
"""Retrieve API key with visual feedback."""
with create_spinner("Opening API key portal...") as progress:
task = progress.add_task("Opening browser...")
webbrowser.open("https://swarms.world/platform/api-keys")
time.sleep(1)
progress.remove_task(task)
console.print(
f"\n[{COLORS['success']}]✓ API key page opened in your browser[/{COLORS['success']}]"
)
def check_login():
"""Verify login status with enhanced visual feedback."""
cache_file = "cache.txt"
if os.path.exists(cache_file):
with open(cache_file, "r") as f:
if f.read() == "logged_in":
console.print(
f"[{COLORS['success']}]✓ Authentication verified[/{COLORS['success']}]"
)
return True
with create_spinner("Authenticating...") as progress:
task = progress.add_task("Initializing session...")
time.sleep(1)
with open(cache_file, "w") as f:
f.write("logged_in")
progress.remove_task(task)
console.print(
f"[{COLORS['success']}]✓ Login successful![/{COLORS['success']}]"
)
return True
def run_autoswarm(task: str, model: str):
"""Run autoswarm with enhanced error handling"""
try:
console.print(
"[yellow]Initializing autoswarm configuration...[/yellow]"
)
# Set LiteLLM verbose mode for debugging
import litellm
litellm.set_verbose = True
# Validate inputs
if not task or task.strip() == "":
raise SwarmCLIError("Task cannot be empty")
if not model or model.strip() == "":
raise SwarmCLIError("Model name cannot be empty")
# Attempt to generate swarm configuration
console.print(
f"[yellow]Generating swarm for task: {task}[/yellow]"
)
result = generate_swarm_config(task=task, model=model)
if result:
console.print(
"[green]✓ Swarm configuration generated successfully![/green]"
)
else:
raise SwarmCLIError(
"Failed to generate swarm configuration"
)
except Exception as e:
if "No YAML content found" in str(e):
show_error(
"Failed to generate YAML configuration",
"This might be due to an API key issue or invalid model configuration.\n"
+ "1. Check if your OpenAI API key is set correctly\n"
+ "2. Verify the model name is valid\n"
+ "3. Try running with --model gpt-4",
)
else:
show_error(
f"Error during autoswarm execution: {str(e)}",
"For debugging, try:\n"
+ "1. Check your API keys are set correctly\n"
+ "2. Verify your network connection\n"
+ "3. Try a different model",
)
def main():
try:
show_ascii_art()
parser = argparse.ArgumentParser(
description="Swarms Cloud CLI"
)
parser.add_argument(
"command",
choices=[
"onboarding",
"help",
"get-api-key",
"check-login",
"run-agents",
"auto-upgrade",
"book-call",
"autoswarm",
],
help="Command to execute",
)
parser.add_argument(
"--yaml-file",
type=str,
default="agents.yaml",
help="YAML configuration file path",
)
parser.add_argument(
"--task", type=str, help="Task for autoswarm"
)
parser.add_argument(
"--model",
type=str,
default="gpt-4",
help="Model for autoswarm",
)
args = parser.parse_args()
try:
if args.command == "onboarding":
OnboardingProcess().run()
elif args.command == "help":
show_help()
elif args.command == "get-api-key":
get_api_key()
elif args.command == "check-login":
check_login()
elif args.command == "run-agents":
try:
console.print(
f"[yellow]Loading agents from {args.yaml_file}...[/yellow]"
)
if not os.path.exists(args.yaml_file):
raise FileNotFoundError(
f"YAML file not found: {args.yaml_file}\n"
"Please make sure the file exists and you're in the correct directory."
)
# Create progress display
progress = Progress(
SpinnerColumn(),
TextColumn(
"[progress.description]{task.description}"
),
console=console,
)
with progress:
# Add initial task
init_task = progress.add_task(
"Initializing...", total=None
)
# Load and validate YAML
progress.update(
init_task,
description="Loading YAML configuration...",
)
# Create agents
progress.update(
init_task,
description="Creating agents...",
)
result = create_agents_from_yaml(
yaml_file=args.yaml_file,
return_type="run_swarm",
)
# Update progress on completion
progress.update(
init_task,
description="Processing complete!",
completed=True,
)
if result:
# Format and display the results
if isinstance(result, str):
console.print(
"\n[bold green]Results:[/bold green]"
)
console.print(
Panel(
result,
title="Agent Output",
border_style="green",
)
)
elif isinstance(result, dict):
console.print(
"\n[bold green]Results:[/bold green]"
)
for key, value in result.items():
console.print(
f"[cyan]{key}:[/cyan] {value}"
)
else:
console.print(
"[green]✓ Agents completed their tasks successfully![/green]"
)
else:
console.print(
"[yellow]⚠ Agents completed but returned no results.[/yellow]"
)
except FileNotFoundError as e:
show_error("File Error", str(e))
except ValueError as e:
show_error(
"Configuration Error",
str(e)
+ "\n\nPlease check your agents.yaml file format.",
)
except Exception as e:
# Enhanced error handling
error_msg = str(e)
if "context_length_exceeded" in error_msg:
show_error(
"Context Length Error",
"The model's context length was exceeded. Try:\n"
"1. Reducing max_tokens in your YAML config\n"
"2. Reducing context_length in your YAML config\n"
"3. Using a model with larger context window",
)
elif "api_key" in error_msg.lower():
show_error(
"API Key Error",
"There seems to be an issue with the API key. Please:\n"
"1. Check if your API key is set correctly\n"
"2. Verify the API key is valid\n"
"3. Run 'swarms get-api-key' to get a new key",
)
else:
show_error(
"Execution Error",
f"An unexpected error occurred: {error_msg}\n"
"1. Check your YAML configuration\n"
"2. Verify your API keys are set\n"
"3. Check network connectivity",
)
elif args.command == "book-call":
webbrowser.open(
"https://cal.com/swarms/swarms-strategy-session"
)
elif args.command == "autoswarm":
if not args.task:
show_error(
"Missing required argument: --task",
"Example usage: python cli.py autoswarm --task 'analyze this data' --model gpt-4",
)
exit(1)
run_autoswarm(args.task, args.model)
except Exception as e:
console.print(
f"[{COLORS['error']}]Error: {str(e)}[/{COLORS['error']}]"
)
return
except Exception as error:
formatter.print_panel(
f"Error detected: {error} check your args"
)
raise error
if __name__ == "__main__":
main()