{"id":48335926,"url":"https://github.com/eugen-goebel/tech-trend-agent","last_synced_at":"2026-04-05T02:03:10.948Z","repository":{"id":347705774,"uuid":"1193095581","full_name":"eugen-goebel/tech-trend-agent","owner":"eugen-goebel","description":"Multi-agent system that generates comprehensive technology trend reports","archived":false,"fork":false,"pushed_at":"2026-03-29T04:36:55.000Z","size":52,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-29T07:28:17.187Z","etag":null,"topics":["anthropic","automation","docker","docx-report","market-analysis","multi-agent","pydantic","python","trend-analysis"],"latest_commit_sha":null,"homepage":null,"language":"Python","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/eugen-goebel.png","metadata":{"files":{"readme":"README.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-26T21:45:36.000Z","updated_at":"2026-03-29T04:37:33.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/eugen-goebel/tech-trend-agent","commit_stats":null,"previous_names":["eugen-goebel/tech-trend-agent"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/eugen-goebel/tech-trend-agent","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eugen-goebel%2Ftech-trend-agent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eugen-goebel%2Ftech-trend-agent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eugen-goebel%2Ftech-trend-agent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eugen-goebel%2Ftech-trend-agent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eugen-goebel","download_url":"https://codeload.github.com/eugen-goebel/tech-trend-agent/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eugen-goebel%2Ftech-trend-agent/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31421870,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-05T00:25:07.052Z","status":"online","status_checked_at":"2026-04-05T02:00:05.211Z","response_time":75,"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":["anthropic","automation","docker","docx-report","market-analysis","multi-agent","pydantic","python","trend-analysis"],"created_at":"2026-04-05T02:03:10.303Z","updated_at":"2026-04-05T02:03:10.941Z","avatar_url":"https://github.com/eugen-goebel.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Tech Trend Report Agent\n\nAn AI-powered multi-agent system that generates technology trend reports. Enter any technology — Artificial Intelligence, Blockchain, Quantum Computing — and get a professional Word document with market analysis, key players, use cases, and strategic outlook.\n\n![CI](https://github.com/eugen-goebel/tech-trend-agent/actions/workflows/tests.yml/badge.svg)\n![Python](https://img.shields.io/badge/Python-3.10+-blue)\n![Tests](https://img.shields.io/badge/Tests-52_passed-brightgreen)\n![Anthropic SDK](https://img.shields.io/badge/Anthropic_SDK-0.49+-cc785c)\n![License](https://img.shields.io/badge/License-MIT-green)\n\n---\n\n## Architecture\n\n```\nCLI Input (\"Quantum Computing\")\n        │\n        ▼\n┌─────────────────────┐\n│    Orchestrator      │  Coordinates the 3-phase pipeline\n└────────┬────────────┘\n         │\n    ┌────┴─────┐\n    ▼          ▼\n┌────────┐ ┌──────────┐\n│Research│ │ Analysis │\n│ Agent  │ │  Agent   │\n└────┬───┘ └────┬─────┘\n     │          │\n     ▼          ▼\n┌─────────────────────┐\n│   Report Generator   │ → DOCX Output\n└─────────────────────┘\n```\n\n| Agent | Role | Technology |\n|-------|------|-----------|\n| **ResearchAgent** | Gathers live web intelligence on the technology | Server-side web search, adaptive thinking |\n| **AnalysisAgent** | Extracts structured insights from raw research | Structured outputs (Pydantic), adaptive thinking |\n| **ReportGenerator** | Produces a professional multi-page DOCX report | python-docx with color-coded tables |\n\n---\n\n## Quickstart\n\n```bash\n# 1. Clone the repo\ngit clone https://github.com/eugen-goebel/tech-trend-agent.git\ncd tech-trend-agent\n\n# 2. Install dependencies\npip install -r requirements.txt\n\n# 3a. Test without an API key (uses sample AI data)\npython main.py --dry-run\n\n# 3b. Full run with Anthropic API key\necho \"ANTHROPIC_API_KEY=sk-ant-...\" \u003e .env\npython main.py \"Quantum Computing\"\npython main.py \"Blockchain\"\npython main.py \"Edge Computing\"\n```\n\nThe report is saved to `./output/tech_trend_\u003ctechnology\u003e_\u003cdate\u003e.docx`.\n\n---\n\n## Testing\n\n```bash\n# Run the full test suite (52 tests, no API key needed)\npython -m pytest tests/ -v\n```\n\nThe test suite covers:\n- **Model validation** — Pydantic schemas, Literal constraints, serialization\n- **Mock data integrity** — ensures dry-run data is complete and valid\n- **Report generation** — DOCX output, section presence, table structure\n- **Agent logic** — web search tool usage, pause_turn handling, structured outputs\n- **CLI integration** — argument parsing, dry-run mode, error handling\n\n---\n\n## Example Output\n\nRunning `python main.py \"Artificial Intelligence\"` produces a ~10-page Word document:\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/report_preview.png\" alt=\"Example report for Artificial Intelligence\" width=\"600\"\u003e\n\u003c/p\u003e\n\n---\n\n## Project Structure\n\n```\ntech-trend-agent/\n├── main.py                       # CLI entry point (supports --dry-run)\n├── agents/\n│   ├── researcher.py             # Web search intelligence gathering\n│   ├── analyst.py                # Structured analysis (Pydantic models)\n│   ├── orchestrator.py           # Pipeline coordinator\n│   └── mock_data.py              # AI sample data for --dry-run mode\n├── utils/\n│   └── report_generator.py       # Professional DOCX generation\n├── tests/\n│   ├── test_models.py            # Pydantic model validation tests\n│   ├── test_mock_data.py         # Mock data integrity tests\n│   ├── test_report_generator.py  # DOCX generation tests\n│   ├── test_agents.py            # Agent logic tests (mocked API)\n│   └── test_cli.py               # CLI integration tests\n├── output/                       # Generated reports (git-ignored)\n├── requirements.txt\n└── .env.example\n```\n\n---\n\n## Tech Stack\n\n| Component | Technology |\n|-----------|-----------|\n| AI Backend | Anthropic API (claude-opus-4-6) |\n| Structured Outputs | Pydantic v2 + `messages.parse()` |\n| Server-side Search | `web_search_20260209` tool |\n| Report Generation | python-docx |\n| Testing | pytest (52 tests) |\n| Thinking Mode | Adaptive thinking |\n\n---\n\n## Report Sections\n\n1. **Cover Page** — Technology name, date, system branding\n2. **Executive Summary** — High-level overview\n3. **Technology Overview** — How the technology works\n4. **Maturity Assessment** — Adoption lifecycle stage\n5. **Market Landscape** — Market size, growth, regional split\n6. **Key Players** — Major companies with focus areas (table)\n7. **Use Cases** — Real-world applications with impact levels (color-coded table)\n8. **Strengths \u0026 Limitations** — Two-column comparison table\n9. **Adoption Drivers \u0026 Barriers** — Two-column comparison table\n10. **Key Trends** — Current industry developments\n11. **Future Outlook** — 3-5 year predictions\n12. **Risk Factors** — Threats and challenges\n\n---\n\n## License\n\nMIT License — see [LICENSE](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feugen-goebel%2Ftech-trend-agent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feugen-goebel%2Ftech-trend-agent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feugen-goebel%2Ftech-trend-agent/lists"}