{
  "markdown": "# Agentics Foundation TV5 Hackathon\n\n[![License: Apache-2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)\n[![npm version](https://img.shields.io/badge/npm-agentics--hackathon-red.svg)](https://www.npmjs.com/package/agentics-hackathon)\n[![Discord](https://img.shields.io/badge/Discord-Agentics-7289da.svg)](https://discord.agentics.org)\n\n> **Build the future of agentic AI - Supported by Google Cloud**\n\nThe **Agentics Foundation TV5 Hackathon** repository provides CLI tools, MCP servers, and reference implementations for building agentic AI solutions. This includes the **AI Media Discovery** demo app showcasing the Agent-Ready Web (ARW) specification.\n\n🌐 **Website:** [agentics.org/hackathon](https://agentics.org/hackathon)\n💬 **Discord:** [discord.agentics.org](https://discord.agentics.org)\n📦 **npm:** `npx agentics-hackathon`\n\n---\n\n## 🎯 The Challenge\n\nEvery night, millions spend up to **45 minutes deciding what to watch** — billions of hours lost every day. Not from lack of content, but from fragmentation across streaming platforms.\n\nJoin us to build agentic AI solutions that solve real problems using Google Cloud, Gemini, Claude, and open-source tools.\n\n---\n\n## 🚀 Quick Start\n\n```bash\n# Initialize your hackathon project\nnpx agentics-hackathon init\n\n# Browse and install 17+ AI tools\nnpx agentics-hackathon tools\n\n# Check project status\nnpx agentics-hackathon status\n\n# Start MCP server for AI assistant integration\nnpx agentics-hackathon mcp\n```\n\n---\n\n## 🏆 Hackathon Tracks\n\n| Track | Description |\n|-------|-------------|\n| **Entertainment Discovery** | Solve the 45-minute decision problem - help users find what to watch |\n| **Multi-Agent Systems** | Build collaborative AI agents with Google ADK and Vertex AI |\n| **Agentic Workflows** | Create autonomous workflows with Claude, Gemini, and orchestration |\n| **Open Innovation** | Bring your own idea - any agentic AI solution that makes an impact |\n\n---\n\n## ✨ Features\n\n### 🛠 CLI Tool (`npx agentics-hackathon`)\n\n- **`init`** - Interactive project setup with track selection and tool installation\n- **`tools`** - Browse and install 17+ AI development tools across 6 categories\n- **`status`** - View project configuration and installed tools\n- **`info`** - Hackathon information and resources\n- **`mcp`** - Start MCP server (stdio or SSE transport)\n- **`discord`** - Join the community\n- **`help`** - Detailed guides and examples\n\n### 🤖 MCP Server\n\nFull Model Context Protocol implementation with:\n- **Tools**: `get_hackathon_info`, `get_tracks`, `get_available_tools`, `get_project_status`, `check_tool_installed`, `get_resources`\n- **Resources**: Project configuration, track information\n- **Prompts**: `hackathon_starter`, `choose_track`\n\n### 📱 Demo Applications\n\n| App | Description |\n|-----|-------------|\n| **[Media Discovery](apps/media-discovery/)** | AI-powered movie/TV discovery with ARW implementation |\n| **[ARW Chrome Extension](apps/arw-chrome-extension/)** | Browser extension for inspecting ARW compliance |\n\n### 📐 ARW (Agent-Ready Web) Components\n\nThis repository includes reference implementations of the ARW specification:\n\n- **Specification**: [ARW v0.1 Draft](spec/ARW-0.1-draft.md)\n- **Schemas**: JSON schemas for validation (`packages/schemas/`)\n- **Validators**: Python and Node.js validation tools (`packages/validators/`)\n- **Badges**: Compliance level badges (`packages/badges/`)\n\n---\n\n## 📦 Repository Structure\n\n```plaintext\nhackathon-tv5/\n├── src/                             # Hackathon CLI source\n│   ├── cli.ts                      # Main CLI entry point\n│   ├── commands/                   # CLI commands (init, tools, status, etc.)\n│   ├── mcp/                        # MCP server implementation\n│   │   ├── server.ts              # MCP tools, resources, prompts\n│   │   ├── stdio.ts               # STDIO transport\n│   │   └── sse.ts                 # SSE transport\n│   ├── constants.ts               # Tracks, tools, configuration\n│   └── utils/                     # Helpers and utilities\n│\n├── apps/                           # Demo Applications\n│   ├── media-discovery/           # AI Media Discovery (Next.js + ARW)\n│   │   ├── public/\n│   │   │   ├── .well-known/arw-manifest.json  # ARW manifest\n│   │   │   └── llms.txt                       # ARW discovery file\n│   │   └── src/                   # React components & API routes\n│   └── arw-chrome-extension/      # ARW Inspector Chrome Extension\n│       ├── manifest.json          # Chrome Manifest V3\n│       └── src/                   # Popup, content script, service worker\n│\n├── packages/                       # Shared Packages\n│   ├── @arw/schemas/              # TypeScript ARW schemas with Zod\n│   ├── schemas/                   # JSON schemas for ARW validation\n│   ├── validators/                # Python & Node.js validators\n│   ├── validator/                 # ARW validator CLI tool\n│   ├── badges/                    # ARW compliance badges (SVG)\n│   ├── cli/                       # Rust ARW CLI (advanced)\n│   ├── crawler-sdk/               # TypeScript SDK for ARW crawler service\n│   ├── crawler-service/           # High-performance crawler API service\n│   ├── nextjs-plugin/             # Next.js plugin for ARW integration\n│   └── benchmark/                 # ARW benchmark evaluation\n│\n├── spec/                           # ARW Specification\n│   └── ARW-0.1-draft.md           # Editor's draft specification\n│\n├── docs/                           # Documentation\n├── ai_docs/                        # AI-focused documentation\n├── scripts/                        # Build and utility scripts\n│\n├── .claude/                        # Claude Code configuration\n│   ├── commands/                  # Slash commands\n│   └── agents/                    # Sub-agent definitions\n│\n├── CLAUDE.md                       # Claude Code guidance\n└── README.md                       # This file\n```\n\n---\n\n## 🔧 Available Tools (17+)\n\nThe CLI provides access to tools across 6 categories:\n\n### AI Assistants\n- **Claude Code CLI** - Anthropic's AI-powered coding assistant\n- **Gemini CLI** - Google's Gemini model interface\n\n### Orchestration & Agent Frameworks\n- **Claude Flow** - #1 agent orchestration platform with 101 MCP tools\n- **Agentic Flow** - Production AI orchestration with 66 agents\n- **Flow Nexus** - Competitive agentic platform on MCP\n- **Google ADK** - Build multi-agent systems with Google's Agent Development Kit\n\n### Cloud Platform\n- **Google Cloud CLI** - gcloud SDK for Vertex AI, Cloud Functions\n- **Vertex AI SDK** - Google Cloud's unified ML platform\n\n### Databases & Memory\n- **RuVector** - Vector database and embeddings toolkit\n- **AgentDB** - Database for agentic AI state management\n\n### Synthesis & Advanced Tools\n- **Agentic Synth** - Synthesis tools for agentic development\n- **Strange Loops** - Consciousness exploration SDK\n- **SPARC 2.0** - Autonomous vector coding agent\n\n### Python Frameworks\n- **LionPride** - Python agentic AI framework\n- **Agentic Framework** - AI agents with natural language\n- **OpenAI Agents SDK** - Multi-agent workflows from OpenAI\n\n---\n\n## 🌐 ARW (Agent-Ready Web)\n\nThis repository demonstrates the ARW specification through the **Media Discovery** app.\n\n### What is ARW?\n\nARW provides infrastructure for efficient agent-web interaction:\n\n- **85% token reduction** - Machine views vs HTML scraping\n- **10x faster discovery** - Structured manifests vs crawling\n- **OAuth-enforced actions** - Safe agent transactions\n- **AI-* headers** - Full observability of agent traffic\n\n### ARW in Media Discovery\n\nThe media-discovery app implements ARW with:\n\n```json\n// /.well-known/arw-manifest.json\n{\n  \"version\": \"0.1\",\n  \"profile\": \"ARW-1\",\n  \"site\": {\n    \"name\": \"AI Media Discovery\",\n    \"description\": \"Discover movies and TV shows through natural language\"\n  },\n  \"actions\": [\n    {\n      \"id\": \"semantic_search\",\n      \"endpoint\": \"/api/search\",\n      \"method\": \"POST\"\n    }\n  ]\n}\n```\n\nSee the [ARW Specification](spec/ARW-0.1-draft.md) for full details.\n\n---\n\n## 💻 Development\n\n### Prerequisites\n\n- Node.js 18+\n- npm or pnpm\n\n### Build & Run\n\n```bash\n# Install dependencies\nnpm install\n\n# Build the CLI\nnpm run build\n\n# Run locally\nnpm start\n\n# Development mode (watch)\nnpm run dev\n\n# Run linter\nnpm run lint\n```\n\n### MCP Server\n\n```bash\n# STDIO transport (for Claude Desktop, etc.)\nnpm run mcp:stdio\n\n# SSE transport (for web integrations)\nnpm run mcp:sse\n```\n\n### Media Discovery App\n\n```bash\ncd apps/media-discovery\nnpm install\nnpm run dev\n```\n\n---\n\n## 🔌 MCP Integration\n\nAdd to your Claude Desktop config (`claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"agentics-hackathon\": {\n      \"command\": \"npx\",\n      \"args\": [\"agentics-hackathon\", \"mcp\"]\n    }\n  }\n}\n```\n\nOr use SSE transport:\n\n```bash\nnpx agentics-hackathon mcp sse --port 3000\n```\n\n---\n\n## 🤝 Contributing\n\nWe welcome contributions! Areas of focus:\n\n1. **CLI Improvements** - New commands, better UX\n2. **Tool Integrations** - Add more AI tools\n3. **Demo Apps** - Build showcases for hackathon tracks\n4. **ARW Implementation** - Expand specification coverage\n5. **Documentation** - Guides and tutorials\n\n### Development Workflow\n\nSee [CLAUDE.md](CLAUDE.md) for development guidelines including:\n- SPARC methodology for systematic development\n- Concurrent execution patterns\n- File organization rules\n\n---\n\n## 📜 License\n\nThis project is licensed under the [Apache License 2.0](LICENSE).\n\n---\n\n## 🔗 Links\n\n- **🌐 Hackathon Website:** [agentics.org/hackathon](https://agentics.org/hackathon)\n- **💬 Discord:** [discord.agentics.org](https://discord.agentics.org)\n- **📦 GitHub:** [github.com/agenticsorg/hackathon-tv5](https://github.com/agenticsorg/hackathon-tv5)\n- **📖 ARW Spec:** [ARW v0.1 Draft](spec/ARW-0.1-draft.md)\n\n---\n\n<div align=\"center\">\n\n**🚀 Agentics Foundation TV5 Hackathon**\n\n*Building the Future of Agentic AI - Supported by Google Cloud*\n\n[Website](https://agentics.org/hackathon) | [Discord](https://discord.agentics.org) | [GitHub](https://github.com/agenticsorg/hackathon-tv5)\n\n</div>\n",
  "bytes": 10054,
  "sha": "48c8dd0f0b194b8edf68eeb606d4a415f074186ecff4f44ae29a9af2cfb0c19b",
  "repo_slug": "agenticsorg/hackathon-tv5",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_agenticsorg_hackathon_tv5_claude_skills__b7fa3c4a/readme"
}