Skip to content

Releases: RubenGarrod/ClinicCloud

First Stable Release

11 Nov 14:13
@RubenGarrod RubenGarrod
v1.0.0
79b4b22

Choose a tag to compare

View all tags
First Stable Release Latest
Latest

ClinicCloud v1.0.0 - First Stable Release

ClinicCloud v1.0.0 marks the first stable release of our advanced semantic search system for medical and scientific documentation. This release provides a fully functional platform for healthcare professionals to search and organize medical literature.

Key Features

🔍 Advanced Semantic Search

  • Medical-specialized AI model: S-PubMedBert-MS-MARCO (BioBERT fine-tuned)
  • 768-dimensional vector embeddings for accurate semantic matching
  • 25+ medical specialties for filtering results
  • Multilingual support: Spanish and English
  • Sort by: Relevance, date, or author
  • Auto-translation of abstracts (Azure Translator API)

👤 User Management

  • Secure JWT authentication with bcrypt password hashing
  • Customizable profiles: 35 animal avatars × 16 colors = 560 combinations
  • Language preferences (ES/EN)
  • Password recovery via email
  • Email verification system

📚 Personal Library

  • Save documents for future reference
  • Personal notes per document
  • Customizable tag system for organization
  • Advanced filtering by tags
  • Rich metadata: MeSH terms, DOI, journal, publication types

📊 History & Analytics

  • Complete search history tracking
  • Filter history recorded
  • Result counts per search
  • Anonymous user support with temporary sessions

🛠️ Technical Infrastructure

  • Containerized microservices with Docker
  • PostgreSQL 16 with pgvector extension
  • Redis 7 for caching and rate limiting
  • Continuous scraper for PubMed data
  • FastAPI 0.101.0 backend (async)
  • React 19.1 frontend with Tailwind CSS
  • Health checks for all services
  • Portainer CE for container management

🖥️ Platform Support

Platform Status Notes
Desktop/Laptop ✅ Fully optimized Primary target platform
Tablet ✅ Functional Landscape mode recommended
Mobile ⚠️ Functional UI optimization planned for v1.1.0

Note: ClinicCloud is designed primarily for desktop use, matching the workflow of healthcare professionals conducting literature research.

⚠️ Known Limitations

  • Mobile UI requires horizontal scrolling in some views
  • Mobile navigation could be improved
  • Touch interactions not fully optimized

These will be addressed in v1.1.0 (Q1 2025).

🚀 Quick Start

Prerequisites

  • Docker 20.10+ and Docker Compose 2.0+
  • 4GB RAM minimum (8GB recommended)
  • 20GB disk space

Installation

Clone the repository and start all services:

git clone https://github.com/RubenGarrod/cliniccloud.git
cd cliniccloud
docker-compose up -d

Wait for services to be ready (approximately 2-5 minutes on first run), then verify status:

docker-compose ps

Access the Application

Getting Started

No default credentials needed - create your account on first access at http://localhost:80

📚 Documentation

🛠️ Tech Stack

Backend:

  • FastAPI 0.101.0 + Uvicorn 0.23.2
  • PostgreSQL 16 + pgvector
  • Redis 7 Alpine
  • Python 3.11

AI/ML:

  • Sentence Transformers 2.2.2
  • S-PubMedBert-MS-MARCO (BioBERT fine-tuned on MS-MARCO)
  • Transformers 4.30.2
  • Specialized medical NLP

Frontend:

  • React 19.1
  • React Router 7.5.3
  • Tailwind CSS 3.4
  • i18next 25.1

Infrastructure:

  • Docker & Docker Compose
  • Nginx
  • Scrapy 2.12.0

🗺️ Roadmap

v1.1.0 (Q1 2025) - Mobile Optimization

  • Responsive design improvements
  • Touch-friendly controls
  • Hamburger menu navigation
  • Mobile-optimized layouts

v1.2.0 (Q2 2025) - AI Assistant

  • RAG (Retrieval-Augmented Generation)
  • Contextualized answers from scientific evidence
  • Conversation history
  • Medical terminology simplification

v1.3.0 (Q2 2025) - Integrations

  • MCP Server integration
  • Claude Desktop integration
  • Export to PDF/BibTeX
  • Analytics dashboards

🐛 Known Issues

No critical issues reported for core functionality.

Report bugs via:

🤝 Contributing

Contributions are welcome! See Contributing Guidelines for details.

We need help with:

  • Mobile UI optimization
  • Automated testing
  • Additional language translations
  • UI/UX improvements
  • Documentation

🙏 Acknowledgments

  • PubMed/NCBI - Free access to medical literature
  • HuggingFace - S-PubMedBert-MS-MARCO model
  • Open Source Community - Incredible tools and libraries
  • Healthcare professionals - Inspiration for this project

📄 License

GNU General Public License v3.0 (GPL-3.0)

Copyright (C) 2025 Rubén García Rodríguez

See LICENSE for complete terms.

📧 Contact & Support

Rubén García Rodríguez

🎓 Citation

If you use ClinicCloud in your research, please cite:

@software{cliniccloud2025,
  author = {García Rodríguez, Rubén},
  title = {ClinicCloud: Advanced Semantic Search for Medical Literature},
  year = {2025},
  version = {1.0.0},
  url = {https://github.com/RubenGarrod/cliniccloud}
}

Full Changelog: CHANGELOG.md

Assets 2
Loading