{"id":"b48df842-878d-43b2-9488-627a1682af34","entityType":"agent","slug":"crewai-serkanyasr-vocavoice","name":"vocavoice","canonicalUrl":"https://www.xpersona.co/agent/crewai-serkanyasr-vocavoice","canonicalPath":"/agent/crewai-serkanyasr-vocavoice","generatedAt":"2026-10-09T22:45:43.527Z","source":"GITHUB_REPOS","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":null},"description":"AI-powered podcast generator for language learners. Creates custom scripts and audio using CrewAI, OpenAI, and TTS. <p align=\"center\"> <h1 align=\"center\">VocaVoice</h1> </p> <p align=\"center\"> <img src=\"https://img.shields.io/github/license/serkanyasr/vocavoice?style=default&logo=opensourceinitiative&logoColor=white&color=0080ff\" alt=\"license\"> <img src=\"https://img.shields.io/github/last-commit/serkanyasr/vocavoice?style=default&logo=git&logoColor=white&color=0080ff\" alt=\"last-commit\"> <img src=\"https://img.shields.io/github/lang","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 3 GitHub stars reported by the source. Last updated 4/15/2026.","installCommand":null,"sourceUrl":"https://github.com/serkanyasr/vocavoice","homepage":null,"primaryLinks":[{"label":"View Source","url":"https://github.com/serkanyasr/vocavoice","kind":"source"}],"safetyScore":66,"overallRank":21.2,"popularityScore":15,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"AI-powered podcast generator for language learners. Creates custom scripts and audio using CrewAI, OpenAI, and TTS. <p align=\"center\"> <h1 align=\"center\">VocaVo"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[{"label":"crewai","status":"self-declared"},{"label":"multi-agent","status":"self-declared"}],"verifiedCount":0,"selfDeclaredCount":3,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"},{"key":"crewai","type":"capability","support":"supported","confidenceSource":"profile","notes":"Declared in agent profile metadata"},{"key":"multi-agent","type":"capability","support":"supported","confidenceSource":"profile","notes":"Declared in agent profile metadata"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile capability:crewai|supported|profile capability:multi-agent|supported|profile"}},"adoption":{"evidence":{"source":"GITHUB REPOS","verified":false,"confidence":"medium","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":null},"stars":3,"forks":0,"downloads":null,"packageName":null,"latestVersion":null,"tractionLabel":"3 GitHub stars"},"release":{"evidence":{"source":"agent-index","verified":false,"confidence":"medium","updatedAt":"2026-02-25T05:06:45.762Z","emptyReason":null},"lastUpdatedAt":"2026-04-15T05:21:22.124Z","lastCrawledAt":"2026-02-25T05:06:45.762Z","lastIndexedAt":null,"nextCrawlAt":"2026-03-04T05:06:45.762Z","lastVerifiedAt":null,"highlights":[]},"execution":{"evidence":{"source":"GITHUB REPOS","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":null,"setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/crewai-serkanyasr-vocavoice/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/crewai-serkanyasr-vocavoice/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/crewai-serkanyasr-vocavoice/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/crewai-serkanyasr-vocavoice/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/crewai-serkanyasr-vocavoice/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/crewai-serkanyasr-vocavoice/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"GITHUB_REPOS","generatedAt":"2026-10-09T22:45:43.527Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/crewai-serkanyasr-vocavoice/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/crewai-serkanyasr-vocavoice/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/crewai-serkanyasr-vocavoice/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/crewai-serkanyasr-vocavoice/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"GITHUB REPOS","verified":false,"confidence":"high","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":null},"readme":"<p align=\"center\">\n  <h1 align=\"center\">VocaVoice</h1>\n</p>\n\n<p align=\"center\">\n  <img src=\"https://img.shields.io/github/license/serkanyasr/vocavoice?style=default&logo=opensourceinitiative&logoColor=white&color=0080ff\" alt=\"license\">\n  <img src=\"https://img.shields.io/github/last-commit/serkanyasr/vocavoice?style=default&logo=git&logoColor=white&color=0080ff\" alt=\"last-commit\">\n  <img src=\"https://img.shields.io/github/languages/top/serkanyasr/vocavoice?style=default&color=0080ff\" alt=\"repo-top-language\">\n  <img src=\"https://img.shields.io/github/languages/count/serkanyasr/vocavoice?style=default&color=0080ff\" alt=\"repo-language-count\">\n</p>\n\n---\n\n## 📍 Overview\n\n**VocaVoice** is an AI-powered vocabulary learning tool that generates podcast-style episodes tailored to your language level, voice preference, and chosen topic. Built with [CrewAI](https://docs.crewai.com), [OpenAI](https://openai.com/), and [Streamlit](https://streamlit.io/).\n\n## 🎧 Demo\n\nhttps://github.com/user-attachments/assets/a9f3238f-feca-4974-91b2-3b0a73622748\n\n\n\n## 🎯 Example Use Case\n\n- You are an A2-level English learner and select English as your language.\n- You choose the topic \"Technology\", pick a calm voice, and provide your personal vocabulary list.\n- VocaVoice generates a podcast script, simplifies it based on your level, and produces an audio version for listening practice.\n\n\n## ✨ Features\n\n- 🧠 AI-generated scripts based on your selected topic and level\n- 📜 Simplified vocabulary explanations\n- 🎤 Text-to-speech podcast creation\n- 📂 Auto-organized outputs (scripts + audio)\n- 🌐 Web UI via Streamlit for non-technical users\n\n---\n\n---\n\n## 🧱 Project Structure\n\n```bash\nvocavoice/\n├── src/\n│   └── vocavoice/\n│       ├── config/           # Configuration files\n│       ├── tools/            # Assistant tools\n│       ├── ui/               # User interface components\n│       ├── crew.py           # CrewAI configuration\n│       ├── main.py           # Main application\n│       └── ui_vocavoice.py   # Streamlit interface\n├── tests/                    # Test files\n├── pyproject.toml           # Project dependencies\n└── README.md\n```\n\n---\n\n## 🚀 Getting Started\n\n### ☑️ Prerequisites\n\n- Python >=3.10 <3.13\n- UV (Dependency Management)\n\n### ⚙️ Installation\n\nFirst, install UV:\n\n```bash\n❯ pip install uv\n```\n\nNavigate to your project directory and install dependencies:\n\n```bash\n# Clone the repository\n❯ git clone https://github.com/serkanyasr/vocavoice\n❯ cd vocavoice\n\n# Install dependencies\n❯ uv tool install crewai\n❯ crewai install\n```\n\n### 🔧 Customization\n\n**Add your `OPENAI_API_KEY` to the `.env` file**\n\n- Modify `src/vocavoice/config/agents.yaml` to define your agents\n- Modify `src/vocavoice/config/tasks.yaml` to define your tasks\n- Modify `src/vocavoice/crew.py` to add your own logic, tools and specific args\n- Modify `src/vocavoice/main.py` to add custom inputs for your agents and tasks\n\n\n\n## 🤖 Running the Project\n\nTo start your VocaVoice agents and begin task execution, run this from the root folder:\n\n```bash\n❯ crewai run\n```\n\nThis command initializes the VocaVoice crew, assembling the agents and assigning them tasks as defined in your configuration.\n\n### Running with Streamlit Interface:\n```bash\n❯ streamlit run src/vocavoice/ui/streamlit_ui.py\n```\n\n## 🧠 Understanding Your Crew\n\nThe VocaVoice crew consists of multiple AI agents, each with unique roles, goals, and tools. These agents collaborate on a series of tasks, defined in `config/tasks.yaml`, leveraging their collective skills to achieve complex objectives. The `config/agents.yaml` file outlines the capabilities and configurations of each agent in your crew.\n\n---\n\n## 🧪 Development / Contributing\n\n- Fork the repo and create feature branches\n- Submit a PR with a description of your changes\n- Tag @serkanyasr in issues or PRs\n\n---\n\n## 🎗 License\n\nThis project is licensed under the MIT License. For more details, refer to the [LICENSE](LICENCE) file.\n\n---\n","readmeExcerpt":"<p align=\"center\"> <h1 align=\"center\">VocaVoice</h1> </p> <p align=\"center\"> <img src=\"https://img.shields.io/github/license/serkanyasr/vocavoice?style=default&logo=opensourceinitiative&logoColor=white&color=0080ff\" alt=\"license\"> <img src=\"https://img.shields.io/github/last-commit/serkanyasr/vocavoice?style=default&logo=git&logoColor=white&color=0080ff\" alt=\"last-commit\"> <img src=\"https://img.shields.io/github/lang","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"vocavoice/\n├── src/\n│   └── vocavoice/\n│       ├── config/           # Configuration files\n│       ├── tools/            # Assistant tools\n│       ├── ui/               # User interface components\n│       ├── crew.py           # CrewAI configuration\n│       ├── main.py           # Main application\n│       └── ui_vocavoice.py   # Streamlit interface\n├── tests/                    # Test files\n├── pyproject.toml           # Project dependencies\n└── README.md"},{"language":"bash","snippet":"❯ pip install uv"},{"language":"bash","snippet":"# Clone the repository\n❯ git clone https://github.com/serkanyasr/vocavoice\n❯ cd vocavoice\n\n# Install dependencies\n❯ uv tool install crewai\n❯ crewai install"},{"language":"bash","snippet":"❯ crewai run"},{"language":"bash","snippet":"❯ streamlit run src/vocavoice/ui/streamlit_ui.py"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[],"languages":["python"],"docsSourceLabel":"GITHUB REPOS","editorialOverview":"AI-powered podcast generator for language learners. Creates custom scripts and audio using CrewAI, OpenAI, and TTS. <p align=\"center\"> <h1 align=\"center\">VocaVoice</h1> </p> <p align=\"center\"> <img src=\"https://img.shields.io/github/license/serkanyasr/vocavoice?style=default&logo=opensourceinitiative&logoColor=white&color=0080ff\" alt=\"license\"> <img src=\"https://img.shields.io/github/last-commit/serkanyasr/vocavoice?style=default&logo=git&logoColor=white&color=0080ff\" alt=\"last-commit\"> <img src=\"https://img.shields.io/github/lang","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":368,"uniquenessScore":68,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-09T22:45:43.527Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/github_repos","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}