{"id":26421124,"url":"https://github.com/agentoverlay/openai-agent-sdk-visualizer","last_synced_at":"2025-10-28T11:33:10.450Z","repository":{"id":282814865,"uuid":"949729732","full_name":"agentoverlay/openai-agent-sdk-visualizer","owner":"agentoverlay","description":"openai agent sdk visualizer","archived":false,"fork":false,"pushed_at":"2025-03-17T04:05:04.000Z","size":382,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-03-17T05:23:09.263Z","etag":null,"topics":["agent-sdk","graph","openai","openai-agent-sdk","visualizer"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/agentoverlay.png","metadata":{"files":{"readme":"README-DIRECTORY.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-17T03:31:54.000Z","updated_at":"2025-03-17T04:05:07.000Z","dependencies_parsed_at":"2025-03-17T05:33:15.690Z","dependency_job_id":null,"html_url":"https://github.com/agentoverlay/openai-agent-sdk-visualizer","commit_stats":null,"previous_names":["agentoverlay/openai-agent-sdk-visualizer"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agentoverlay%2Fopenai-agent-sdk-visualizer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agentoverlay%2Fopenai-agent-sdk-visualizer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agentoverlay%2Fopenai-agent-sdk-visualizer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agentoverlay%2Fopenai-agent-sdk-visualizer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/agentoverlay","download_url":"https://codeload.github.com/agentoverlay/openai-agent-sdk-visualizer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244141539,"owners_count":20404836,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-sdk","graph","openai","openai-agent-sdk","visualizer"],"created_at":"2025-03-18T02:01:25.272Z","updated_at":"2025-10-28T11:33:05.411Z","avatar_url":"https://github.com/agentoverlay.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Visualizing a Directory of Agent Files\n\nThis guide explains how to use the Agent Visualizer to analyze a directory containing OpenAI Agents SDK Python files.\n\n## Visualizing a Directory\n\n### On macOS/Linux:\n\n1. Make the script executable (first time only):\n```bash\nchmod +x visualize-dir.sh\n```\n\n2. Run the script with the path to your directory:\n```bash\n./visualize-dir.sh /path/to/your/agent/files\n```\n\n### On Windows:\n\n1. Run the script with the path to your directory:\n```\nvisualize-dir.bat C:\\path\\to\\your\\agent\\files\n```\n\n## What the Script Does\n\n1. Scans the directory for all Python (.py) files\n2. Parses each file for OpenAI Agents SDK patterns (agents, tools, contexts, etc.)\n3. Starts the visualization server if it's not already running\n4. Opens your browser to the visualization\n\n## Troubleshooting\n\n### No Agents Found\n\nIf the visualization shows no agents, check that your Python files:\n- Contain proper OpenAI Agents SDK code\n- Use standard patterns (e.g., `agent = Agent(name=\"...\")`)\n- Have proper indentation and syntax\n\n### Other Issues\n\n- Make sure Node.js is installed and accessible\n- Check that you have all dependencies installed (`npm install`)\n- If the server doesn't start, try running it manually with `npm run dev`\n\n## Example\n\nLet's say you have a directory with multiple agent files:\n\n```\n/my-agents/\n├── account_agent.py\n├── triage_agent.py\n└── support_agent.py\n```\n\nSimply run:\n```bash\n./visualize-dir.sh /my-agents\n```\n\nThis will parse all three Python files and visualize their relationships.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagentoverlay%2Fopenai-agent-sdk-visualizer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fagentoverlay%2Fopenai-agent-sdk-visualizer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagentoverlay%2Fopenai-agent-sdk-visualizer/lists"}