{"id":28033055,"url":"https://github.com/moduscreateorg/app-med-ai-gen","last_synced_at":"2025-05-11T09:11:22.091Z","repository":{"id":282928086,"uuid":"938253773","full_name":"ModusCreateOrg/app-med-ai-gen","owner":"ModusCreateOrg","description":null,"archived":false,"fork":false,"pushed_at":"2025-05-07T11:23:16.000Z","size":13064,"stargazers_count":1,"open_issues_count":2,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-05-07T12:22:51.701Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/ModusCreateOrg.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","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-02-24T16:58:42.000Z","updated_at":"2025-05-06T21:32:53.000Z","dependencies_parsed_at":"2025-05-07T12:33:28.409Z","dependency_job_id":null,"html_url":"https://github.com/ModusCreateOrg/app-med-ai-gen","commit_stats":null,"previous_names":["moduscreateorg/app-med-ai-gen"],"tags_count":0,"template":false,"template_full_name":"ModusCreateOrg/template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ModusCreateOrg%2Fapp-med-ai-gen","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ModusCreateOrg%2Fapp-med-ai-gen/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ModusCreateOrg%2Fapp-med-ai-gen/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ModusCreateOrg%2Fapp-med-ai-gen/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ModusCreateOrg","download_url":"https://codeload.github.com/ModusCreateOrg/app-med-ai-gen/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253540837,"owners_count":21924537,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":"2025-05-11T09:11:21.455Z","updated_at":"2025-05-11T09:11:22.075Z","avatar_url":"https://github.com/ModusCreateOrg.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Smart Medical Reports Explainer\n\n[![MIT Licensed](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](./LICENSE)\n[![Powered by Modus_Create](https://img.shields.io/badge/powered_by-Modus_Create-blue.svg?longCache=true\u0026style=flat\u0026logo=data:image/svg+xml;base64,PHN2ZyB2aWV3Qm94PSIwIDAgMzIwIDMwMSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KICA8cGF0aCBkPSJNOTguODI0IDE0OS40OThjMCAxMi41Ny0yLjM1NiAyNC41ODItNi42MzcgMzUuNjM3LTQ5LjEtMjQuODEtODIuNzc1LTc1LjY5Mi04Mi43NzUtMTM0LjQ2IDAtMTcuNzgyIDMuMDkxLTM0LjgzOCA4Ljc0OS01MC42NzVhMTQ5LjUzNSAxNDkuNTM1IDAgMCAxIDQxLjEyNCAxMS4wNDYgMTA3Ljg3NyAxMDcuODc3IDAgMCAwLTcuNTIgMzkuNjI4YzAgMzYuODQyIDE4LjQyMyA2OS4zNiA0Ni41NDQgODguOTAzLjMyNiAzLjI2NS41MTUgNi41Ny41MTUgOS45MjF6TTY3LjgyIDE1LjAxOGM0OS4xIDI0LjgxMSA4Mi43NjggNzUuNzExIDgyLjc2OCAxMzQuNDggMCA4My4xNjgtNjcuNDIgMTUwLjU4OC0xNTAuNTg4IDE1MC41ODh2LTQyLjM1M2M1OS43NzggMCAxMDguMjM1LTQ4LjQ1OSAxMDguMjM1LTEwOC4yMzUgMC0zNi44NS0xOC40My02OS4zOC00Ni41NjItODguOTI3YTk5Ljk0OSA5OS45NDkgMCAwIDEtLjQ5Ny05Ljg5NyA5OC41MTIgOTguNTEyIDAgMCAxIDYuNjQ0LTM1LjY1NnptMTU1LjI5MiAxODIuNzE4YzE3LjczNyAzNS41NTggNTQuNDUgNTkuOTk3IDk2Ljg4OCA1OS45OTd2NDIuMzUzYy02MS45NTUgMC0xMTUuMTYyLTM3LjQyLTEzOC4yOC05MC44ODZhMTU4LjgxMSAxNTguODExIDAgMCAwIDQxLjM5Mi0xMS40NjR6bS0xMC4yNi02My41ODlhOTguMjMyIDk4LjIzMiAwIDAgMS00My40MjggMTQuODg5QzE2OS42NTQgNzIuMjI0IDIyNy4zOSA4Ljk1IDMwMS44NDUuMDAzYzQuNzAxIDEzLjE1MiA3LjU5MyAyNy4xNiA4LjQ1IDQxLjcxNC01MC4xMzMgNC40Ni05MC40MzMgNDMuMDgtOTcuNDQzIDkyLjQzem01NC4yNzgtNjguMTA1YzEyLjc5NC04LjEyNyAyNy41NjctMTMuNDA3IDQzLjQ1Mi0xNC45MTEtLjI0NyA4Mi45NTctNjcuNTY3IDE1MC4xMzItMTUwLjU4MiAxNTAuMTMyLTIuODQ2IDAtNS42NzMtLjA4OC04LjQ4LS4yNDNhMTU5LjM3OCAxNTkuMzc4IDAgMCAwIDguMTk4LTQyLjExOGMuMDk0IDAgLjE4Ny4wMDguMjgyLjAwOCA1NC41NTcgMCA5OS42NjUtNDAuMzczIDEwNy4xMy05Mi44Njh6IiBmaWxsPSIjRkZGIiBmaWxsLXJ1bGU9ImV2ZW5vZGQiLz4KPC9zdmc+)](https://moduscreate.com)\n\nAI-powered medical report translator that simplifies complex medical documents for patients and caregivers. This application helps users understand their health conditions, diagnoses, and test results without relying on unreliable online searches.\n\nThis project proposes an AI-powered medical report translator that simplifies complex medical documents for patients and caregivers. By leveraging AI-driven text extraction and natural language processing (NLP), the system translates medical jargon into plain language, helping users understand their health conditions, diagnoses, and test results without relying on unreliable online searches.\n\n## Application Workflow\n\n\u003cdiv align=\"center\"\u003e\n  \u003ctable\u003e\n    \u003ctr\u003e\n      \u003ctd align=\"center\"\u003e\u003cb\u003eHome Screen\u003c/b\u003e\u003c/td\u003e\n      \u003ctd align=\"center\"\u003e\u003cb\u003eDocument Upload\u003c/b\u003e\u003c/td\u003e\n      \u003ctd align=\"center\"\u003e\u003cb\u003eProcessing\u003c/b\u003e\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003e\u003cimg src=\"docs/assets/images/1%20-%20Home.png\" width=\"250\"/\u003e\u003c/td\u003e\n      \u003ctd\u003e\u003cimg src=\"docs/assets/images/3%20-%20upload2.png\" width=\"250\"/\u003e\u003c/td\u003e\n      \u003ctd\u003e\u003cimg src=\"docs/assets/images/4%20-%20processing.png\" width=\"250\"/\u003e\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd align=\"center\"\u003e\u003cb\u003eResults Analysis\u003c/b\u003e\u003c/td\u003e\n      \u003ctd align=\"center\"\u003e\u003cb\u003eResults Archive\u003c/b\u003e\u003c/td\u003e\n      \u003ctd align=\"center\"\u003e\u003cb\u003eAI Integration\u003c/b\u003e\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003e\u003cimg src=\"docs/assets/images/5%20-%20Results%20analysis.png\" width=\"250\"/\u003e\u003c/td\u003e\n      \u003ctd\u003e\u003cimg src=\"docs/assets/images/6%20-%20Results%20Archive.png\" width=\"250\"/\u003e\u003c/td\u003e\n      \u003ctd\u003e\u003cimg src=\"docs/assets/images/8%20-%20%20AI.png\" width=\"250\"/\u003e\u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/table\u003e\n\u003c/div\u003e\n\n\n## Project Packages\n\n| Package   | Description                       | Status    |\n|-----------|-----------------------------------|-----------|\n| Frontend  | Ionic/React mobile application    | Active    |\n| Backend   | API and ML services               | Planned   |\n\n## Getting Started\n\nPlease see individual package READMEs for setup instructions:\n\n- [Frontend](./frontend/README.md)\n\u003c!-- - [Backend](./backend/README.md) (Coming soon) --\u003e\n\n- [Getting Started](#getting-started)\n- [How it Works](#how-it-works)\n- [Developing](#developing)\n  - [Prerequisites](#prerequisites)\n  - [Docker Setup](#docker-setup)\n  - [Testing](#testing)\n  - [Contributing](#contributing)\n- [Modus Create](#modus-create)\n- [Licensing](#licensing)\n\n# Getting Started\n\nTo run the application using Docker:\n\n```bash\n# Start all services\nnpm run dev\n\n# Stop all services\nnpm run down\n\n# Clean up everything (removes volumes and orphaned containers)\nnpm run clean\n```\n\nThe application will be available at:\n- Frontend: http://localhost:5173\n- Backend API: http://localhost:3000\n\n# How it works\n\nThe application consists of two main components:\n- A NestJS backend service that handles API requests and AI processing\n- A Vue.js frontend that provides the user interface\n\nBoth services are containerized using Docker for consistent development and deployment.\n\n# Developing\n\n## Prerequisites\n\n- Docker Engine 24.0.0+\n- Node.js 20.x+ (for local development)\n- npm 10.x+ (for local development)\n\n## Docker Setup\n\nThe project uses Docker Compose for development. The setup includes:\n\n```\nmedical-reports-explainer/\n├── backend/           # NestJS backend application\n├── frontend/          # Vue.js frontend application\n├── docker-compose.yml # Docker services configuration\n└── package.json      # Root level npm scripts\n```\n\n### Environment Variables\n\nBackend:\n```\nNODE_ENV=development\nPORT=3000\n```\n\nFrontend:\n```\nVITE_API_URL=http://backend:3000\n```\n\n### Troubleshooting\n\n1. If containers fail to start:\n```bash\nnpm run clean\nnpm run dev\n```\n\n2. For port conflicts:\n```bash\n# Find the process using the port\nsudo lsof -i :3000  # or :5173\n# Kill the process\nkill -9 \u003cPID\u003e\n```\n\n3. View container logs:\n```bash\n# All containers\ndocker compose logs\n\n# Specific service\ndocker compose logs backend\ndocker compose logs frontend\n```\n\n## Testing\n\n{Notes on testing}\n\n## Contributing\n\nSee [Contribution Guidelines](.github/CONTRIBUTING.md) and [Code of Conduct](.github/CODE_OF_CONDUCT.md).\n\n# Modus Create\n\n[Modus Create](https://moduscreate.com) is a digital product consultancy. We use a distributed team of the best talent in the world to offer a full suite of digital product design-build services; ranging from consumer facing apps, to digital migration, to agile development training, and business transformation.\n\n\u003ca href=\"https://moduscreate.com/?utm_source=labs\u0026utm_medium=github\u0026utm_campaign=PROJECT_NAME\"\u003e\u003cimg src=\"https://res.cloudinary.com/modus-labs/image/upload/h_80/v1533109874/modus/logo-long-black.svg\" height=\"80\" alt=\"Modus Create\"/\u003e\u003c/a\u003e\n\u003cbr /\u003e\n\nThis project is part of [Modus Labs](https://labs.moduscreate.com/?utm_source=labs\u0026utm_medium=github\u0026utm_campaign=PROJECT_NAME).\n\n\u003ca href=\"https://labs.moduscreate.com/?utm_source=labs\u0026utm_medium=github\u0026utm_campaign=PROJECT_NAME\"\u003e\u003cimg src=\"https://res.cloudinary.com/modus-labs/image/upload/h_80/v1531492623/labs/logo-black.svg\" height=\"80\" alt=\"Modus Labs\"/\u003e\u003c/a\u003e\n\n# Licensing\n\nThis project is [MIT licensed](./LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmoduscreateorg%2Fapp-med-ai-gen","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmoduscreateorg%2Fapp-med-ai-gen","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmoduscreateorg%2Fapp-med-ai-gen/lists"}