{"id":28946662,"url":"https://github.com/dmitriz/archon-hello-world","last_synced_at":"2025-10-08T23:55:19.744Z","repository":{"id":297372268,"uuid":"996539570","full_name":"dmitriz/archon-hello-world","owner":"dmitriz","description":null,"archived":false,"fork":false,"pushed_at":"2025-06-05T05:59:18.000Z","size":35,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-23T08:49:49.290Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dmitriz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"zenodo":null}},"created_at":"2025-06-05T05:13:24.000Z","updated_at":"2025-06-05T05:59:19.000Z","dependencies_parsed_at":"2025-06-05T07:39:56.270Z","dependency_job_id":"92dd8b94-047b-4e0b-998a-0581183f0276","html_url":"https://github.com/dmitriz/archon-hello-world","commit_stats":null,"previous_names":["dmitriz/archon-hello-world"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/dmitriz/archon-hello-world","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmitriz%2Farchon-hello-world","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmitriz%2Farchon-hello-world/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmitriz%2Farchon-hello-world/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmitriz%2Farchon-hello-world/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dmitriz","download_url":"https://codeload.github.com/dmitriz/archon-hello-world/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmitriz%2Farchon-hello-world/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279000708,"owners_count":26082862,"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","status":"online","status_checked_at":"2025-10-08T02:00:06.501Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2025-06-23T08:41:56.654Z","updated_at":"2025-10-08T23:55:19.740Z","avatar_url":"https://github.com/dmitriz.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Hello World Agent\n\nA simple AI agent built with [Pydantic AI](https://ai.pydantic.dev/) that demonstrates the basic structure and functionality of an agent created through the [Archon Agent Builder](https://github.com/dmitriz/Archon).\n\n## Overview\n\nThis project showcases a minimal AI agent implementation that responds with \"Hello, World!\" to any user input. It serves as a foundational example for understanding how Pydantic AI agents are structured and can be extended for more complex use cases.\n\n## Features\n\n- **Simple Response Logic**: Always responds with \"Hello, World!\" regardless of input\n- **Async Support**: Built with asynchronous operations for scalability\n- **Clean Architecture**: Follows Archon's agent structure with separate files for:\n  - Agent definition (`agent.py`)\n  - Tools (`agent_tools.py`) \n  - Prompts (`agent_prompts.py`)\n  - Main execution (`main.py`)\n\n## Project Structure\n\n```\narchon-hello-world/\n├── agent.py           # Main agent class definition\n├── agent_tools.py     # Agent tools (empty for this simple example)\n├── agent_prompts.py   # Agent prompts (empty for this simple example)\n├── main.py           # Entry point to run the agent\n├── requirements.txt  # Python dependencies\n├── pyproject.toml    # UV project configuration\n├── uv.lock          # Dependency lock file\n└── README.md        # This file\n```\n\n## Generated by Archon\n\nThis agent was generated using the **Archon Agent Builder**, an AI-powered tool that creates complete Pydantic AI agents based on natural language descriptions.\n\n**Original Request**: *\"Create a simple hello world agent that just says 'Hello, World!' when asked anything.\"*\n\nArchon automatically generated:\n- Complete agent implementation\n- Proper project structure\n- Dependencies and configuration\n- Documentation and examples\n\nLearn more about Archon at: [Archon Agent Builder](https://github.com/dmitriz/Archon)\n\n## Requirements\n\n- Python 3.11+\n- UV package manager (recommended) or pip\n\n## Installation\n\n1. Clone or download this project\n2. Install dependencies using UV (recommended):\n   ```bash\n   uv add pydantic-ai\n   ```\n   \n   Or using pip:\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n## Usage\n\nRun the agent interactively:\n\n```bash\npython main.py\n```\n\nThe agent will prompt you to ask anything, and it will respond with \"Hello, World!\" regardless of your input.\n\n### Example Interaction\n\n```\n$ python main.py\nAsk anything: What's the weather like?\nHello, World!\n```\n\n```\n$ python main.py\nAsk anything: How are you?\nHello, World!\n```\n\n## Code Example\n\nThe core agent implementation is straightforward:\n\n```python\nfrom pydantic_ai import Agent\n\nclass HelloWorldAgent(Agent):\n    async def run(self, user_input: str) -\u003e str:\n        \"\"\"Responds with 'Hello, World!' to any input given.\"\"\"\n        return \"Hello, World!\"\n\nhello_world_agent = HelloWorldAgent()\n```\n\n## Extending This Agent\n\nThis simple agent can be extended by:\n\n1. **Adding Tools**: Implement functions in `agent_tools.py` for external API calls, file operations, etc.\n2. **Custom Prompts**: Define system prompts and user message templates in `agent_prompts.py`\n3. **Enhanced Logic**: Modify the `run` method to include conditional responses, AI model integration, etc.\n4. **State Management**: Add context tracking for multi-turn conversations\n\n## Development\n\nThis project uses:\n- **Pydantic AI**: For agent framework and validation\n- **UV**: For fast Python package management\n- **Git**: Version control with feature branch workflow\n\n## License\n\nThis project is part of the Archon ecosystem. See the main [Archon repository](https://github.com/dmitriz/Archon) for license information.\n\n## Next Steps\n\n- Try modifying the response in `agent.py`\n- Add conditional logic based on user input\n- Integrate with external APIs using tools\n- Explore more complex agent patterns in the Archon documentation\n\n---\n\n*Generated with ❤️ by Archon Agent Builder*","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdmitriz%2Farchon-hello-world","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdmitriz%2Farchon-hello-world","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdmitriz%2Farchon-hello-world/lists"}