{"id":28962361,"url":"https://github.com/gamithasam/blackboard","last_synced_at":"2026-05-18T15:33:29.758Z","repository":{"id":300564134,"uuid":"997751839","full_name":"gamithasam/blackboard","owner":"gamithasam","description":"An AI-powered educational video creation tool that automatically generates narrated mathematical animations using GPT, Manim, and Text-to-Speech technology.","archived":false,"fork":false,"pushed_at":"2025-08-05T07:31:43.000Z","size":2928,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-05T09:27:12.397Z","etag":null,"topics":["education","manim-python","openai-api","openai-gpt","pythonkit","swift","swiftui","text-to","video-generation"],"latest_commit_sha":null,"homepage":"","language":"Swift","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/gamithasam.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}},"created_at":"2025-06-07T05:23:04.000Z","updated_at":"2025-08-05T07:31:46.000Z","dependencies_parsed_at":"2025-07-08T17:35:38.696Z","dependency_job_id":null,"html_url":"https://github.com/gamithasam/blackboard","commit_stats":null,"previous_names":["gamithasam/blackboard"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/gamithasam/blackboard","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gamithasam%2Fblackboard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gamithasam%2Fblackboard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gamithasam%2Fblackboard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gamithasam%2Fblackboard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gamithasam","download_url":"https://codeload.github.com/gamithasam/blackboard/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gamithasam%2Fblackboard/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33182848,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-18T09:27:30.708Z","status":"ssl_error","status_checked_at":"2026-05-18T09:27:28.300Z","response_time":71,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["education","manim-python","openai-api","openai-gpt","pythonkit","swift","swiftui","text-to","video-generation"],"created_at":"2025-06-24T03:04:59.586Z","updated_at":"2026-05-18T15:33:29.738Z","avatar_url":"https://github.com/gamithasam.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Blackboard AI 🎓: AI-Powered Educational Video Creation\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"Screenshots/NewConversation.png\" alt=\"Blackboard AI Interface\" width=\"80%\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cem\u003eBlackboard AI - Educational content creation with AI, Manim, and TTS\u003c/em\u003e\n\u003c/p\u003e\n\n\u003e **🚧 Project Status: In Active Development**  \n\u003e Blackboard AI is currently under active development. While core functionality is working, features are being refined and new capabilities are being added regularly. Expect frequent updates and improvements!\n\n**Blackboard AI** is an innovative educational content creation tool that automatically generates narrated mathematical videos using the power of AI. By combining OpenAI's ChatGPT, Manim (Mathematical Animation Engine), and advanced Text-to-Speech technology, Blackboard AI transforms educational concepts into engaging visual explanations.\n\n## ✨ Features\n\n- 🤖 **AI-Powered Content Generation**: Leverages OpenAI's GPT models to create educational scripts and mathematical explanations\n- 📊 **Mathematical Animations**: Uses Manim to generate beautiful, precise mathematical visualizations\n- 🎙️ **Text-to-Speech Integration**: Converts generated scripts into natural-sounding narration\n- 🎬 **Automated Video Production**: Seamlessly combines animations with voiceover to create complete educational videos\n- 🖥️ **macOS Desktop App**: Native macOS application with intuitive user interface\n- 📚 **Educational Focus**: Specifically designed for mathematical and scientific content creation\n\n## 🚀 Getting Started\n\n\u003e **⚠️ Development Notice**  \n\u003e This project is currently in development. Installation and setup processes may change as the project evolves. Check back for updates and stable releases.\n\n### Prerequisites\n\n- macOS (for the desktop app)\n- Xcode (for development)\n- OpenAI API key\n\n### Installation (Development Version)\n\n1. **Clone the repository**\n   ```bash\n   git clone https://github.com/yourusername/blackboard.git\n   cd blackboard\n   ```\n\n2. **Open in Xcode**\n   ```bash\n   open \"Blackboard AI/Blackboard AI.xcodeproj\"\n   ```\n\n3. **Set up your OpenAI API key**\n   - Run the application from Xcode\n   - Go to Settings within the app\n   - Add your OpenAI API key\n\n4. **Build and run**\n   - Use Xcode to build and run the application\n\n### 📦 Releases\n\n**Coming Soon!** I'm working on packaging Blackboard AI for easier installation:\n- macOS App Bundle (.app) - *In Development* (will include Python environment)\n- Web Application - *Planned* (after Aether framework development)\n- Windows Executable - *Planned* (after Aether framework development)\n\nWatch this repository for release announcements!\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"Screenshots/Video.png\" alt=\"Blackboard AI Animation Example\" width=\"80%\"\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003cem\u003eExample: Image Convolution explanation with mathematical animations\u003c/em\u003e\n\u003c/p\u003e\n\n## 🎯 How It Works\n\n1. **Input Your Topic**: Provide a mathematical concept or educational topic you want to explain\n2. **AI Script Generation**: ChatGPT generates a comprehensive script with mathematical explanations\n3. **Animation Creation**: Manim creates corresponding visual animations and mathematical diagrams\n4. **Voice Synthesis**: Text-to-Speech converts the script into natural narration\n5. **Video Assembly**: All components are automatically combined into a final educational video\n\n## ️ Core Components\n\n### Engine.py\nThe heart of Blackboard AI that orchestrates:\n- AI content generation and prompt management\n- Manim scene creation and rendering\n- Text-to-Speech processing\n- Video compilation pipeline\n\n### OpenAI.swift\nHandles OpenAI API integration:\n- GPT model communication\n- API key management\n- Content generation requests\n\n### Desktop Application\nBuilt with Swift and SwiftUI, providing:\n- Intuitive user interface\n- Real-time preview capabilities\n- Project management\n- Export options\n\n## 🎨 Example Use Cases\n\n- **Mathematical Proofs**: Generate step-by-step visual proofs with narration\n- **Scientific Concepts**: Create explanatory videos for physics, chemistry, or biology topics\n- **Educational Tutorials**: Produce comprehensive learning materials for students\n- **Lecture Supplements**: Enhance traditional lectures with engaging visual content\n\n## 📄 License\n\nThis project is licensed under the [MIT License](LICENSE).\n\nThis project incorporates third-party open-source software:\n- **Manim**: [MIT License](https://github.com/ManimCommunity/manim/blob/main/LICENSE)\n- **Coqui TTS**: [MPL-2.0 License](https://github.com/coqui-ai/TTS/blob/main/LICENSE.txt)\n- **PythonKit**: [Apache License 2.0](https://github.com/pvieito/PythonKit/blob/master/LICENSE.txt)\n- **OpenAI API**: Usage governed by [OpenAI's Terms of Use](https://openai.com/policies/terms-of-use)\n\n## 🙏 Acknowledgments\n\n- **Manim**: For providing the mathematical animation framework\n- **OpenAI**: For powering the AI content generation\n- **Swift Community**: For the excellent UI development tools\n\n## 📞 Support\n\nIf you encounter any issues or have questions, please:\n- Open an issue on GitHub\n- Check existing issues for known problems\n- Join our discussions for feature requests and general questions\n\n\u003e **Note**: As this is an active development project, documentation and features may change. I appreciate your patience and feedback as I work to improve Blackboard AI!\n\n---\n\n**Made with ❤️ for educators and learners worldwide**\n\n*⭐ Star this repository to stay updated on my progress!*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgamithasam%2Fblackboard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgamithasam%2Fblackboard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgamithasam%2Fblackboard/lists"}