{"id":43850893,"url":"https://github.com/fidelisaboke/slideia","last_synced_at":"2026-06-14T17:01:12.722Z","repository":{"id":312922704,"uuid":"1047112641","full_name":"Fidelisaboke/slideia","owner":"Fidelisaboke","description":"AI-powered slide generator that creates slide templates from scratch.","archived":false,"fork":false,"pushed_at":"2026-05-07T07:12:24.000Z","size":1274,"stargazers_count":1,"open_issues_count":7,"forks_count":0,"subscribers_count":0,"default_branch":"develop","last_synced_at":"2026-05-07T08:35:25.735Z","etag":null,"topics":["fastapi","llm","mcp","powerpoint-generator","python"],"latest_commit_sha":null,"homepage":"https://slideia.vercel.app","language":"TypeScript","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/Fidelisaboke.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":"audit.json","citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-08-29T19:01:24.000Z","updated_at":"2026-05-07T07:11:03.000Z","dependencies_parsed_at":"2025-09-02T21:33:20.004Z","dependency_job_id":"a6013f09-c775-4eef-8ea9-0e9c1fad6085","html_url":"https://github.com/Fidelisaboke/slideia","commit_stats":null,"previous_names":["fidelisaboke/slideia"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/Fidelisaboke/slideia","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Fidelisaboke%2Fslideia","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Fidelisaboke%2Fslideia/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Fidelisaboke%2Fslideia/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Fidelisaboke%2Fslideia/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Fidelisaboke","download_url":"https://codeload.github.com/Fidelisaboke/slideia/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Fidelisaboke%2Fslideia/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32730282,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-07T02:14:30.463Z","status":"ssl_error","status_checked_at":"2026-05-07T02:14:29.405Z","response_time":62,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6: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":["fastapi","llm","mcp","powerpoint-generator","python"],"created_at":"2026-02-06T06:35:24.768Z","updated_at":"2026-05-07T09:01:17.349Z","avatar_url":"https://github.com/Fidelisaboke.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Slideia\n\n## Project Overview\n\nSlideia is an open-source application and service for generating presentation slide decks using large language models (LLMs). Built as a modern monorepo, it features a Next.js frontend and a FastAPI backend. It can propose outlines, draft slide content, and export to PowerPoint via API, UI, CLI, or MCP protocol.\n\n## Repository Structure\n\nThis project is structured as a monorepo using **Turborepo**, **pnpm workspaces**, and **uv workspaces** to natively support multi-language local caching and fast builds.\n\n- `apps/frontend/`: Next.js web application for the UI.\n- `apps/backend/`: FastAPI Python application handling presentation generation, LLM integrations, and PowerPoint exports.\n- `packages/`: Shared configurations and common tooling.\n\n## Tech Stack\n\n### Frontend\n\n- Next.js (React)\n- Tailwind CSS / ui.shadcn\n- pnpm\n\n### Backend\n\n- Python 3.11+\n- FastAPI (HTTP API)\n- python-pptx (PowerPoint export)\n- MCP (Model Context Protocol) server\n- pytest \u0026 ruff (testing and linting)\n- uv (Python package manager)\n\n### Infrastructure\n\n- Turborepo\n- Docker / Docker Compose\n- GitHub Actions\n\n## Installation and Setup\n\n### Pre-requisites\n\n- Node.js 20+ and `pnpm`\n- Python 3.11+ and `uv`\n- API key for OpenRouter\n\n### Setup Instructions\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/Fidelisaboke/slideia.git\n   cd slideia\n   ```\n2. Install all dependencies (Node and Python) from the root workspace:\n   ```bash\n   pnpm install\n   uv sync --all-packages\n   ```\n3. Set up LLM API keys for the backend:\n   - For OpenRouter: `export OPENROUTER_API_KEY=your_api_key`\n   - Alternatively, create an `.env` file in `apps/backend/` and set `OPENROUTER_API_KEY=your_api_key`\n\n## Basic Usage\n\n- **Run the full local development stack (Frontend \u0026 Backend):**\n  ```bash\n  pnpm turbo run dev\n  ```\n- **Run the validation pipeline (Linting \u0026 Testing):**\n  ```bash\n  pnpm turbo run lint test\n  ```\n- **Run the MCP server independently:**\n  ```bash\n  cd apps/backend\n  uv run python -m slideia.server\n  ```\n- **Generate a full slide deck via API:**\n  ```bash\n  curl -X POST http://localhost:8000/generate_deck \\\n  \t-H 'Content-Type: application/json' \\\n  \t-d '{\"topic\": \"AI in Education\", \"audience\": \"Teachers\", \"tone\": \"formal\", \"slides\": 5}'\n  ```\n\n## Acknowledgement\n\n- Built with inspiration from the open-source LLM and presentation tooling community.\n- Uses OpenRouter for free LLM access.\n\n## License\n\nThis project is licensed under the terms of the MIT License. See the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffidelisaboke%2Fslideia","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffidelisaboke%2Fslideia","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffidelisaboke%2Fslideia/lists"}