{"id":50345291,"url":"https://github.com/devbyray/docs-for-ai","last_synced_at":"2026-05-29T19:30:53.813Z","repository":{"id":341366019,"uuid":"1169849784","full_name":"devbyray/docs-for-ai","owner":"devbyray","description":"Convert any file to Markdown — REST API, Nuxt 3 web UI, and MCP server. Powered by Microsoft markitdown.","archived":false,"fork":false,"pushed_at":"2026-03-01T10:20:15.000Z","size":98,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-01T14:32:38.495Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/devbyray.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-01T10:14:00.000Z","updated_at":"2026-03-01T10:20:18.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/devbyray/docs-for-ai","commit_stats":null,"previous_names":["devbyray/docs-for-ai"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/devbyray/docs-for-ai","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devbyray%2Fdocs-for-ai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devbyray%2Fdocs-for-ai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devbyray%2Fdocs-for-ai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devbyray%2Fdocs-for-ai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devbyray","download_url":"https://codeload.github.com/devbyray/docs-for-ai/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devbyray%2Fdocs-for-ai/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33668185,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-29T02:00:06.066Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2026-05-29T19:30:53.148Z","updated_at":"2026-05-29T19:30:53.806Z","avatar_url":"https://github.com/devbyray.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MarkItDown\n\n\u003e Convert any file to Markdown — with a web UI, a REST API, and an MCP server for AI assistants.\n\nBuilt on top of Microsoft's [markitdown](https://github.com/microsoft/markitdown) library.\n\n---\n\n## What's inside\n\n| Package | Description |\n|---|---|\n| [`api/`](./api) | FastAPI service — accepts file uploads, returns Markdown |\n| [`frontend/`](./frontend) | Nuxt 3 web UI — drag-and-drop converter with live output |\n| [`mcp/`](./mcp) | MCP server — exposes conversion tools to AI assistants (Claude Desktop, VS Code, etc.) |\n\n## Supported formats\n\nPDF · Word (DOCX) · PowerPoint (PPTX) · Excel (XLSX / XLS) · Images (JPEG, PNG, …) · Audio (WAV, MP3) · HTML · CSV · JSON · XML · EPUB · ZIP · YouTube URLs · and more\n\n---\n\n## Quick start\n\n### Prerequisites\n\n- [Docker](https://docs.docker.com/get-docker/) and [Docker Compose](https://docs.docker.com/compose/)\n\n### Run everything\n\n```bash\ngit clone https://github.com/YOUR_USERNAME/docs-for-ai.git\ncd docs-for-ai\n\n# API + Frontend\ndocker compose --profile frontend up --build -d\n```\n\n| Service | URL |\n|---|---|\n| Web UI | http://localhost:4000 |\n| REST API | http://localhost:8000 |\n| Swagger UI | http://localhost:8000/docs (or http://localhost:4000/docs when frontend is running) |\n\n### API only (no frontend)\n\n```bash\ndocker compose up --build -d\n```\n\nThe API is available at `http://localhost:8000`. Interactive docs at `http://localhost:8000/docs`.\n\n### All services including MCP\n\n```bash\ndocker compose --profile frontend --profile mcp up --build -d\n```\n\n---\n\n## Docker Compose profiles\n\n| Profile flag | Services started |\n|---|---|\n| _(none)_ | `api` only |\n| `--profile frontend` | `api` + `frontend` |\n| `--profile mcp` | adds `mcp` (run on-demand via stdin/stdout) |\n\n```bash\n# Stop everything\ndocker compose --profile frontend --profile mcp down\n```\n\n---\n\n## Project structure\n\n```\ndocs-for-ai/\n├── docker-compose.yml\n├── api/                  # FastAPI backend\n│   ├── Dockerfile\n│   ├── main.py\n│   └── requirements.txt\n├── frontend/             # Nuxt 3 frontend\n│   ├── Dockerfile\n│   ├── nuxt.config.ts\n│   └── app/\n│       └── app.vue\n└── mcp/                  # MCP server\n    ├── Dockerfile\n    ├── server.py\n    ├── requirements.txt\n    └── claude_desktop_config.example.json\n```\n\n---\n\n## Development\n\nEach package can be run independently. See the README in each subfolder for local dev instructions.\n\n- [API →](./api/README.md)\n- [Frontend →](./frontend/README.md)\n- [MCP server →](./mcp/README.md)\n\n---\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevbyray%2Fdocs-for-ai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevbyray%2Fdocs-for-ai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevbyray%2Fdocs-for-ai/lists"}