{"id":28898822,"url":"https://github.com/pskinnertech/gai-askleo","last_synced_at":"2026-05-05T15:31:51.199Z","repository":{"id":300310244,"uuid":"1005845600","full_name":"PSkinnerTech/gai-askleo","owner":"PSkinnerTech","description":"AI-powered medical writing assistant that helps healthcare professionals create accurate clinical documentation including SOAP notes, research papers, and EHR addendums with real-time grammar, spelling, and medical terminology suggestions.","archived":false,"fork":false,"pushed_at":"2025-06-21T00:16:41.000Z","size":299,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-21T01:27:51.956Z","etag":null,"topics":["clinical-writing","fastify","healthcare-ai","healthcare-technology","medical-assistant","medical-documentation","openai-api","react","soap-notes","supabase","typescript"],"latest_commit_sha":null,"homepage":"https://gai-askleo.vercel.app","language":"TypeScript","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/PSkinnerTech.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}},"created_at":"2025-06-20T23:46:25.000Z","updated_at":"2025-06-21T00:24:32.000Z","dependencies_parsed_at":"2025-06-21T01:28:01.377Z","dependency_job_id":"d0cc87eb-cff4-4c2b-800c-773e3ec40115","html_url":"https://github.com/PSkinnerTech/gai-askleo","commit_stats":null,"previous_names":["pskinnertech/gai-askleo"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/PSkinnerTech/gai-askleo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PSkinnerTech%2Fgai-askleo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PSkinnerTech%2Fgai-askleo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PSkinnerTech%2Fgai-askleo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PSkinnerTech%2Fgai-askleo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PSkinnerTech","download_url":"https://codeload.github.com/PSkinnerTech/gai-askleo/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PSkinnerTech%2Fgai-askleo/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261088330,"owners_count":23107676,"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":["clinical-writing","fastify","healthcare-ai","healthcare-technology","medical-assistant","medical-documentation","openai-api","react","soap-notes","supabase","typescript"],"created_at":"2025-06-21T08:00:28.219Z","updated_at":"2026-05-05T15:31:51.195Z","avatar_url":"https://github.com/PSkinnerTech.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Askleo - AI-Powered Medical Documentation Assistant\n\n**Named after Asclepius, the Greek god of healing**\n\nAskleo is an intelligent medical writing assistant designed to solve one of the biggest pain points in healthcare: writing accurate, efficient medical documentation like SOAP notes and other clinical documents.\n\n## 🏥 The Problem\n\nMedical professionals waste countless hours writing documentation when they could be focusing on patient care. Traditional medical note-taking:\n- Slows down clinical workflows\n- Requires mastering complex shorthand systems\n- Often leads to incomplete or inaccurate documentation\n- Takes time away from life-saving activities\n\nAs the creator experienced during mass casualty coordination: \"I always felt like note taking always slowed me down... I genuinely believe I could have saved more lives at a 1.5x increased rate\" with better tools.\n\n## 🚀 The Solution\n\nAskleo combines cutting-edge AI technology to revolutionize medical documentation:\n\n- **Medical Dictionary Libraries** - Ensures clinical accuracy and proper medical terminology\n- **GPT-Powered Analysis** - Real-time checking and intelligent suggestions for improvements\n- **SOAP Formatting** - Specialized templates and formatting for medical documentation standards\n- **Coming Soon: Omi Integration** - Speech-to-text dictation for hands-free note creation\n\n### 🔄 Workflow with Omi Integration\n\n```mermaid\nflowchart TD\n    A[\"Omi Device\u003cbr/\u003e🎤 Audio Recording\"] --\u003e B[\"Speech-to-Text\u003cbr/\u003e🔊 → 📝\"]\n    B --\u003e C[\"Raw Text Input\u003cbr/\u003e📄 Transcribed Speech\"]\n    C --\u003e D[\"Askleo Document\u003cbr/\u003e📋 Text Editor\"]\n    D --\u003e E[\"GPT-4.1 Processing\u003cbr/\u003e🧠 AI Analysis\"]\n    E --\u003e F[\"SOAP Note Format\u003cbr/\u003e📊 Structured Output\"]\n    \n    F --\u003e G[\"Subjective\u003cbr/\u003ePatient's complaints\"]\n    F --\u003e H[\"Objective\u003cbr/\u003eClinical findings\"]\n    F --\u003e I[\"Assessment\u003cbr/\u003eDiagnosis\"]\n    F --\u003e J[\"Plan\u003cbr/\u003eTreatment plan\"]\n    \n    style A fill:#e1f5fe\n    style B fill:#f3e5f5\n    style C fill:#fff3e0\n    style D fill:#e8f5e8\n    style E fill:#fff8e1\n    style F fill:#fce4ec\n    style G fill:#f1f8e9\n    style H fill:#f1f8e9\n    style I fill:#f1f8e9\n    style J fill:#f1f8e9\n```\n\n## ✨ Features\n\n### Real-Time Writing Assistance\n- Intelligent grammar, spelling, and style suggestions\n- Medical terminology validation\n- SOAP note structure guidance\n- Live document analysis and improvements\n\n### Document Management\n- Create and manage SOAP notes, research documents, and EHR addendums\n- Professional medical-grade interface\n- Secure document storage and retrieval\n- Version history and auto-save functionality\n\n### AI-Powered Suggestions\n- WebSocket-based real-time analysis\n- Context-aware medical writing suggestions\n- Rule-based corrections (Grammar, Spelling, Style)\n- Explanations for each suggested improvement\n\n## 🛠 Technology Stack\n\n**Frontend:**\n- React with TypeScript\n- Tailwind CSS for medical-professional styling\n- Real-time WebSocket integration\n- Responsive design for clinical environments\n\n**Backend:**\n- Fastify API with WebSocket support\n- OpenAI GPT integration for intelligent analysis\n- Supabase for authentication and data storage\n- JWT-based secure authentication\n\n**Infrastructure:**\n- Deployed on Fly.io for reliability\n- Real-time communication architecture\n- Scalable cloud infrastructure\n\n## 🎯 Target Users\n\n- **Medical Doctors** - Streamline clinical documentation\n- **Nurses** - Efficient patient care notes\n- **Medical Researchers** - Academic and clinical research documentation\n- **Medical Scribes** - Enhanced documentation workflows\n- **Emergency Responders** - Rapid, accurate incident documentation\n\n## 🚀 Getting Started\n\n### Prerequisites\n- Node.js 20+\n- Bun package manager\n- OpenAI API key\n- Supabase account\n\n### Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/PSkinnerTech/gai-askleo.git\ncd gai-askleo\n\n# Install dependencies\nbun install\n\n# Set up environment variables\ncp .env.example .env\n# Add your OpenAI API key and Supabase credentials\n\n# Start development server\nbun run dev\n\n# Start API server (in separate terminal)\ncd apps/api\nbun run dev\n```\n\n### Environment Setup\n\nCreate a `.env` file with:\n```bash\nOPENAI_API_KEY=your_openai_api_key\nSUPABASE_JWT_SECRET=your_supabase_jwt_secret\n```\n\n## 📋 Usage\n\n1. **Sign Up/Login** - Create your medical professional account\n2. **Create Documents** - Start with SOAP notes, research docs, or EHR addendums\n3. **Write with AI Assistance** - Get real-time suggestions as you type\n4. **Review Suggestions** - Accept or dismiss AI recommendations\n5. **Save and Manage** - Organize your medical documentation library\n\n## 🔮 Coming Soon\n\n- **Omi Device Integration** - Hands-free speech-to-text dictation\n- **Advanced Medical Templates** - Specialized formats for different medical specialties\n- **Team Collaboration** - Share and collaborate on medical documentation\n- **Mobile App** - On-the-go documentation for field medical work\n\n## 🏗 Project Structure\n\n```\naskleo-medical-scribe-ai/\n├── src/                    # Frontend React application\n│   ├── components/         # Reusable UI components\n│   ├── pages/             # Application pages\n│   ├── hooks/             # Custom React hooks\n│   └── integrations/      # External service integrations\n├── apps/api/              # Backend API server\n│   ├── src/               # API source code\n│   └── services/          # Business logic services\n└── supabase/              # Database migrations and config\n```\n\n## 🤝 Contributing\n\nThis project was built as part of the Gauntlet AI program. Contributions are welcome!\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Submit a pull request\n\n## 📄 License\n\nThis project is licensed under the MIT License.\n\n## 🙏 Acknowledgments\n\n- Built during the Gauntlet AI program\n- Inspired by real-world medical documentation challenges\n- Named after Asclepius, honoring the medical profession\n\n---\n\n**\"Saving time on documentation to save more lives.\"**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpskinnertech%2Fgai-askleo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpskinnertech%2Fgai-askleo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpskinnertech%2Fgai-askleo/lists"}