{"id":"b723f6e3-0530-4571-a5f5-f4687111b7fc","entityType":"agent","slug":"crewai-ravishrk124-vwo-genai-assignment","name":"vwo-genai-assignment","canonicalUrl":"https://www.xpersona.co/agent/crewai-ravishrk124-vwo-genai-assignment","canonicalPath":"/agent/crewai-ravishrk124-vwo-genai-assignment","generatedAt":"2026-10-09T23:37:49.685Z","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":"An AI-powered financial document analyzer built with CrewAI and FastAPI. This project demonstrates debugging, prompt engineering, and environment management to fix a buggy codebase and deliver automated investment insights from PDF reports. AI-Powered Financial Document Analyzer A robust system that leverages AI agents to analyze corporate financial documents (such as quarterly reports) and generate comprehensive investment insights. This API allows users to upload a PDF document and receive a detailed analysis covering financial health, market position, risks, and a final investment recommendation. --- System Architecture This project is built using **","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. Last updated 4/15/2026.","installCommand":null,"sourceUrl":"https://github.com/Ravishrk124/vwo-genai-assignment","homepage":null,"primaryLinks":[{"label":"View Source","url":"https://github.com/Ravishrk124/vwo-genai-assignment","kind":"source"}],"safetyScore":66,"overallRank":18,"popularityScore":0,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"An AI-powered financial document analyzer built with CrewAI and FastAPI. This project demonstrates debugging, prompt engineering, and environment management to "},"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":"no-adoption-signals","verified":false,"confidence":"low","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":"No source adoption metrics were available."},"stars":0,"forks":0,"downloads":null,"packageName":null,"latestVersion":null,"tractionLabel":null},"release":{"evidence":{"source":"agent-index","verified":false,"confidence":"medium","updatedAt":"2026-02-25T05:07:01.742Z","emptyReason":null},"lastUpdatedAt":"2026-04-15T05:21:22.124Z","lastCrawledAt":"2026-02-25T05:07:01.742Z","lastIndexedAt":null,"nextCrawlAt":"2026-03-04T05:07:01.742Z","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-ravishrk124-vwo-genai-assignment/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/crewai-ravishrk124-vwo-genai-assignment/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/crewai-ravishrk124-vwo-genai-assignment/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/crewai-ravishrk124-vwo-genai-assignment/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/crewai-ravishrk124-vwo-genai-assignment/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/crewai-ravishrk124-vwo-genai-assignment/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-09T23:37:49.685Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/crewai-ravishrk124-vwo-genai-assignment/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/crewai-ravishrk124-vwo-genai-assignment/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/crewai-ravishrk124-vwo-genai-assignment/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/crewai-ravishrk124-vwo-genai-assignment/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":"# AI-Powered Financial Document Analyzer\n\nA robust system that leverages AI agents to analyze corporate financial documents (such as quarterly reports) and generate comprehensive investment insights. This API allows users to upload a PDF document and receive a detailed analysis covering financial health, market position, risks, and a final investment recommendation.\n\n---\n\n## System Architecture\n\nThis project is built using **CrewAI**, a framework for orchestrating autonomous AI agents. The system follows a sequential process with two specialized agents:\n\n1. **Financial Research Analyst**: Reads the uploaded document, extracts key financial metrics, and creates a concise summary.\n2. **Senior Investment Strategist**: Takes the summary, performs in-depth analysis, and formulates a strategic investment recommendation based on the user’s query.\n\nThis multi-agent approach ensures a clear separation of concerns and produces more accurate insights.\n\n---\n\n## Bugs Found and Fixes Implemented\n\nThe initial codebase had multiple bugs and inconsistencies. Key fixes include:\n\n### 1. Environment & Dependencies (`requirements.txt`)\n- **Bug**: Python 3.9 incompatibility due to modern type-hint syntax → caused `TypeError` in CrewAI.\n- **Fix**: Migrated environment to **Python 3.11** for full compatibility.\n- **Bug**: Missing essential libraries (`python-dotenv`, `uvicorn`, `pypdf`, `langchain-community`, etc.).\n- **Fix**: Added a complete and stable `requirements.txt` with compatible versions (`crewai`, `crewai-tools`, `langchain-google-genai`, etc.).\n\n### 2. Agent & Task Prompts (`agents.py`, `task.py`)\n- **Bug**: Original prompts were satirical and produced irrelevant output.\n- **Fix**: Rewrote agent personas into professional analysts. Redesigned workflow into two steps:\n  1. Extraction & Summarization\n  2. Analysis & Recommendation\n\n### 3. Core Logic (`main.py`)\n- **Bug**: Crew configured with only one agent, ignoring role separation.\n- **Bug**: File path of uploaded document was not passed, so it was never analyzed.\n- **Fix**: Implemented sequential Crew with both agents. Correctly passed `file_path` and `query` to `crew.kickoff()`.\n\n### 4. Tooling (`tools.py`)\n- **Bug**: Used an undefined `Pdf` class → runtime crash.\n- **Fix**: Replaced with **`PyPDFLoader`** from `langchain-community`.\n- **Bug**: Tool not decorated for CrewAI agents.\n- **Fix**: Added `@tool` decorator from `crewai-tools`.\n\n---\n\n## Setup and Usage\n\nFollow these steps to set up and run the project locally.\n\n### Prerequisites\n- Python **3.11**  \n- A **Google AI API Key**\n\n### 1. Clone the Repository\n```sh\ngit clone https://github.com/Ravishrk124/vwo-genai-assignment.git\ncd vwo-genai-assignment\n```\n\n### 2. Create and Activate Virtual Environment\n```sh\npython3.11 -m venv venv\nsource venv/bin/activate\n```\n\n### 3. Install Dependencies\n```sh\npip install -r requirements.txt\n```\n\n### 4. Configure Environment Variables\nCreate a `.env` file in the root directory:\n```\nGOOGLE_API_KEY=\"YOUR_API_KEY_HERE\"\n```\n\n### 5. Run the Application\n```sh\nuvicorn main:app --reload\n```\nThe API will be available at: **http://127.0.0.1:8000**\n\n---\n\n## API Documentation\n\nInteractive docs available at: **http://127.0.0.1:8000/docs**\n\n### Endpoint: `POST /analyze`\n\nUploads a financial PDF, analyzes it, and returns investment insights.\n\n**Parameters:**\n- `query` *(string, optional)* – Custom analysis query  \n  Default: `\"Analyze this financial document for investment insights and provide a recommendation.\"`\n- `file` *(file upload, required)* – Financial document in PDF format  \n\n**Example curl request:**\n```sh\ncurl -X POST \"http://127.0.0.1:8000/analyze\"      -H \"accept: application/json\"      -H \"Content-Type: multipart/form-data\"      -F \"query=What is the outlook for Tesla's energy business based on this report?\"      -F \"file=@/path/to/your/TSLA-Q2-2025-Update.pdf\"\n```\n\n**Successful Response (200 OK):**\n```json\n{\n  \"status\": \"success\",\n  \"query\": \"What is the outlook for Tesla's energy business based on this report?\",\n  \"analysis_result\": \"...\",\n  \"file_processed\": \"TSLA-Q2-2025-Update.pdf\"\n}\n```\n","readmeExcerpt":"AI-Powered Financial Document Analyzer A robust system that leverages AI agents to analyze corporate financial documents (such as quarterly reports) and generate comprehensive investment insights. This API allows users to upload a PDF document and receive a detailed analysis covering financial health, market position, risks, and a final investment recommendation. --- System Architecture This project is built using **","codeSnippets":[],"executableExamples":[{"language":"sh","snippet":"git clone https://github.com/Ravishrk124/vwo-genai-assignment.git\ncd vwo-genai-assignment"},{"language":"sh","snippet":"python3.11 -m venv venv\nsource venv/bin/activate"},{"language":"sh","snippet":"pip install -r requirements.txt"},{"language":"text","snippet":"GOOGLE_API_KEY=\"YOUR_API_KEY_HERE\""},{"language":"sh","snippet":"uvicorn main:app --reload"},{"language":"sh","snippet":"curl -X POST \"http://127.0.0.1:8000/analyze\"      -H \"accept: application/json\"      -H \"Content-Type: multipart/form-data\"      -F \"query=What is the outlook for Tesla's energy business based on this report?\"      -F \"file=@/path/to/your/TSLA-Q2-2025-Update.pdf\""}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[],"languages":["python"],"docsSourceLabel":"GITHUB REPOS","editorialOverview":"An AI-powered financial document analyzer built with CrewAI and FastAPI. This project demonstrates debugging, prompt engineering, and environment management to fix a buggy codebase and deliver automated investment insights from PDF reports. AI-Powered Financial Document Analyzer A robust system that leverages AI agents to analyze corporate financial documents (such as quarterly reports) and generate comprehensive investment insights. This API allows users to upload a PDF document and receive a detailed analysis covering financial health, market position, risks, and a final investment recommendation. --- System Architecture This project is built using **","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":400,"uniquenessScore":67,"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-09T23:37:49.685Z","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"}]}}}