{"id":"892d5ac9-63cd-40ac-8b04-e9e871421a31","entityType":"agent","slug":"crewai-shomec-smart-homework-ai-study-planner","name":"smart-homework-ai-study-planner","canonicalUrl":"https://www.xpersona.co/agent/crewai-shomec-smart-homework-ai-study-planner","canonicalPath":"/agent/crewai-shomec-smart-homework-ai-study-planner","generatedAt":"2026-10-09T12:09:26.197Z","source":"GITHUB_OPENCLEW","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-05-13T06:46:25.149Z","emptyReason":null},"description":"Agentic AI based Smart Homework Study Planner built using CrewAI for multi agent orchestration Smart Homework AI Study Planner # $1 An intelligent, multi-agent AI system that creates personalized, balanced study plans for students. Built with **CrewAI**, **FastAPI**, **React**, and **Docker**. 🌟 Features - **Multi-Agent Collaboration**: Four specialized AI agents work together to plan, schedule, balance, and motivate. - **Personalized Planning**: Takes into account assignments, deadlines, and daily available","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. Last updated 5/13/2026.","installCommand":"git clone https://github.com/shomec/smart-homework-ai-study-planner.git","sourceUrl":"https://github.com/shomec/smart-homework-ai-study-planner","homepage":null,"primaryLinks":[{"label":"View Source","url":"https://github.com/shomec/smart-homework-ai-study-planner","kind":"source"}],"safetyScore":66,"overallRank":18.2,"popularityScore":0,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Agentic AI based Smart Homework Study Planner built using CrewAI for multi agent orchestration Smart Homework AI Study Planner # $1 An intelligent, multi-agent "},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-05-13T06:46:25.149Z","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-05-13T06:46:25.149Z","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-05-13T06:46:25.149Z","emptyReason":null},"lastUpdatedAt":"2026-05-13T06:46:25.149Z","lastCrawledAt":"2026-05-13T06:46:25.149Z","lastIndexedAt":null,"nextCrawlAt":"2026-05-20T06:46:25.149Z","lastVerifiedAt":null,"highlights":[]},"execution":{"evidence":{"source":"GITHUB OPENCLEW","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"git clone https://github.com/shomec/smart-homework-ai-study-planner.git","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-shomec-smart-homework-ai-study-planner/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/crewai-shomec-smart-homework-ai-study-planner/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/crewai-shomec-smart-homework-ai-study-planner/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/crewai-shomec-smart-homework-ai-study-planner/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/crewai-shomec-smart-homework-ai-study-planner/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/crewai-shomec-smart-homework-ai-study-planner/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"GITHUB_OPENCLEW","generatedAt":"2026-10-09T12:09:26.197Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/crewai-shomec-smart-homework-ai-study-planner/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/crewai-shomec-smart-homework-ai-study-planner/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/crewai-shomec-smart-homework-ai-study-planner/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/crewai-shomec-smart-homework-ai-study-planner/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 OPENCLEW","verified":false,"confidence":"high","updatedAt":"2026-05-13T06:46:25.149Z","emptyReason":null},"readme":"# Smart Homework AI Study Planner #\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nAn intelligent, multi-agent AI system that creates personalized, balanced study plans for students. Built with **CrewAI**, **FastAPI**, **React**, and **Docker**.\n\n![Status](https://img.shields.io/badge/Status-Active-success)\n![Docker](https://img.shields.io/badge/Docker-Supported-blue)\n![AI](https://img.shields.io/badge/AI-Ollama%20%2B%20CrewAI-purple)\n\n## 🌟 Features\n\n- **Multi-Agent Collaboration**: Four specialized AI agents work together to plan, schedule, balance, and motivate.\n- **Personalized Planning**: Takes into account assignments, deadlines, and daily available hours.\n- **Well-Being Focused**: Automatically schedules breaks and prevents burnout by balancing daily workload.\n- **Local Private LLM**: Uses a local **Ollama** instance running `llama 3.2` for privacy and cost-efficiency.\n- **Premium UI**: Modern, glassmorphism-inspired interface built with React and Vanilla CSS.\n\n## 🏗 Architecture\n\n### AI Agents (CrewAI)\n1. **🤖 Planner Agent**: Breaks down assignments into manageable study sessions.\n2. **⏳ Time Management Agent**: Estimates durations and distributes workload across the week.\n3. **🧘 Focus & Well-Being Agent**: Ensures breaks are included and workload is age-appropriate.\n4. **🧠 Motivation Agent**: Adds encouraging notes and study tips.\n\n### Tech Stack\n- **Frontend**: React + Vite (Custom Premium CSS)\n- **Backend**: Python FastAPI\n- **Orchestration**: CrewAI + LangChain\n- **LLM**: Ollama (llama3.2)\n- **Database**: PostgreSQL\n- **Infrastructure**: Docker Compose\n\n## 🚀 Getting Started\n\n### Prerequisites\n- [Docker Desktop](https://www.docker.com/products/docker-desktop/) installed.\n\n### Installation & Running\n\n1. **Clone the repository** (if you haven't already):\n   ```bash\n   git clone https://github.com/shomec/smart-homework-ai-study-planner.git\n   cd smart-homework-ai-study-planner\n   ```\n\n2. **Start the application with Docker Compose**:\n   ```bash\n   docker compose up --build\n   ```\n   > **Note**: The first run will take a few minutes as it pulls the Postgres image, builds the services, and downloads the `llama 3.2` model (approx. 3GB) inside the Ollama container.\n\n3. **Verify Services**:\n   - Frontend: [http://localhost:5173](http://localhost:5173)\n   - Backend API: [http://localhost:8000/docs](http://localhost:8000/docs)\n   - Ollama: [http://localhost:11434](http://localhost:11434)\n\n## 📖 Usage Guide\n\n1. Open the **Frontend** at `http://localhost:5173`.\n2. Enter your assignments in natural language.\n   - *Example: \"Math Midterm on Friday, History Essay due Tuesday, read Chapter 4 for Science.\"*\n3. Set your **Daily Study Hours** (e.g., 2 hours/day).\n4. Click **Generate Plan**.\n5. Watch the **Agent Status** badges pulse as the AI team works on your plan.\n6. View your **Weekly Schedule**, complete with breaks and motivational tips!\n\n## 🔧 Troubleshooting\n\n- **Ollama Model Not Found**: If the planner fails or hangs, the model might not have pulled correctly. Run this command manually while the containers are running:\n  ```bash\n  docker compose exec ollama ollama pull llama3.2\n  ```\n- **Port Conflicts**: Ensure ports `5173` (Frontend), `8000` (Backend), and `5432` (Postgres) are free.\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n","readmeExcerpt":"Smart Homework AI Study Planner # $1 An intelligent, multi-agent AI system that creates personalized, balanced study plans for students. Built with **CrewAI**, **FastAPI**, **React**, and **Docker**. 🌟 Features - **Multi-Agent Collaboration**: Four specialized AI agents work together to plan, schedule, balance, and motivate. - **Personalized Planning**: Takes into account assignments, deadlines, and daily available ","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"git clone https://github.com/shomec/smart-homework-ai-study-planner.git\n   cd smart-homework-ai-study-planner"},{"language":"bash","snippet":"docker compose up --build"},{"language":"bash","snippet":"docker compose exec ollama ollama pull llama3.2"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[],"languages":["python"],"docsSourceLabel":"GITHUB OPENCLEW","editorialOverview":"Agentic AI based Smart Homework Study Planner built using CrewAI for multi agent orchestration Smart Homework AI Study Planner # $1 An intelligent, multi-agent AI system that creates personalized, balanced study plans for students. Built with **CrewAI**, **FastAPI**, **React**, and **Docker**. 🌟 Features - **Multi-Agent Collaboration**: Four specialized AI agents work together to plan, schedule, balance, and motivate. - **Personalized Planning**: Takes into account assignments, deadlines, and daily available","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":402,"uniquenessScore":62,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-05-13T06:46:25.149Z","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-05-13T06:46:25.149Z","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-09T12:09:26.197Z","emptyReason":null},"items":[{"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":"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-04-10T18:48:31.762Z","createdAt":"2026-02-25T03:38:16.584Z","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_openclew","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}