fix: Windows/PowerShell docs + public_url for agent-storage:// images (#31)#32
Merged
web3guru888 merged 1 commit intomainfrom May 4, 2026
Merged
Conversation
…#31) ## Changes ### feat: public_url field for agent-storage:// image responses - Add resolve_public_url() to _common/agentverse_relay.py: strips the agent-storage:// prefix to expose a direct browser-openable HTTPS URL - Add enrich_with_public_url() to post-process resource result lists - generate_image.py: success response now includes public_url when the image_url is an agent-storage:// URI - agentverse_chat.py: resource responses enriched with public_url before returning results to the caller - SKILL.md (agentverse-image-gen): updated output examples to show both cases (CDN URL and agent-storage:// with public_url) ### docs: Windows / PowerShell support - README.md: separate macOS/Linux and Windows/PowerShell command blocks in Quick Start; new dedicated 'Windows / PowerShell' section with full setup guide, command cheat sheet, and troubleshooting tips - docs/authentication.md: PowerShell $env: equivalents for both AGENTVERSE_API_KEY and ASI_ONE_API_KEY - docs/troubleshooting.md: PowerShell variant for 'API key not set' error; new 'Windows / PowerShell Issues' section covering py launcher, env var persistence, SSL errors, and backtick line continuation Closes #31
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Fixes #31 — two improvements based on community feedback from @yash.raj.
Summary of changes
🖼️
public_urlforagent-storage://image responsesWhen Agentverse image agents return images via
agent-storage://URIs, the response now also includes apublic_urlfield — a direct browser-openable HTTPS URL.Before:
{ "status": "success", "image_url": "agent-storage://https://agentverse.ai/v1/storage/47cecfda-...", ... }After:
{ "status": "success", "image_url": "agent-storage://https://agentverse.ai/v1/storage/47cecfda-...", "public_url": "https://agentverse.ai/v1/storage/47cecfda-...", ... }Files changed:
skills/_common/agentverse_relay.py— newresolve_public_url()andenrich_with_public_url()helpersskills/agentverse-image-gen/scripts/generate_image.py— addspublic_urlto success responseskills/agentverse-chat/scripts/agentverse_chat.py— enriches resource responses withpublic_urlskills/agentverse-image-gen/SKILL.md— updated output examples for both CDN and agent-storage cases🪟 Windows / PowerShell documentation
Added full Windows support docs so users on PowerShell are not blocked by Unix-only commands.
Files changed:
README.md— separate macOS/Linux and PowerShell command blocks in Quick Start; new dedicated Windows / PowerShell section with$env:VARsyntax,pylauncher, backtick line continuation, persistent env var setup, and troubleshooting tipsdocs/authentication.md— PowerShell$env:equivalents for both API keysdocs/troubleshooting.md— PowerShell variant for 'key not set' error; new Windows / PowerShell Issues sectionTests
pytest tests/ --ignore=tests/test_integration.py)Checklist