Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/artur24814/dicomaestro
DICOM Viewer with Image Manipulation and User Authentication
https://github.com/artur24814/dicomaestro
dicom django-rest-framework docker-compose jwt medical-imaging react
Last synced: about 2 months ago
JSON representation
DICOM Viewer with Image Manipulation and User Authentication
- Host: GitHub
- URL: https://github.com/artur24814/dicomaestro
- Owner: artur24814
- License: mit
- Created: 2024-11-17T23:00:18.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2024-12-05T10:06:05.000Z (2 months ago)
- Last Synced: 2024-12-05T10:33:39.589Z (2 months ago)
- Topics: dicom, django-rest-framework, docker-compose, jwt, medical-imaging, react
- Language: Python
- Homepage:
- Size: 2.97 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# DICOMaestro
DICOMaestro is a free, open-source application for viewing DICOM images and sequences,
exploring metadata, and creating custom DICOM files via an API for developers.
Built with privacy and security in mind, the application does not store any image data,
ensuring compliance with data protection requirements.
Whether you are a medical professional, researcher, or developer,
DICOMaestro provides powerful tools for working with medical imaging data,
along with flexible APIs for integrating its features into your own applications.
Key Features
* DICOM Image Viewer:
Supports single images and sequences such as CT scans or MRIs.
* Metadata Viewer:
Displays detailed metadata from DICOM files.
* Custom DICOM File Creation:
Generate new DICOM files using the developer-friendly API.
* Secure and Private:
Processes data locally without storing sensitive information.
## Installation
### Prerequisites:
* Python 3.8+
* Node.js 16+
* PostgreSQL
### Backend Setup (Django):
* Clone the repository:
```bash
git clone https://github.com/yourusername/DICOMaestro.git
cd DICOMaestro/backend
```
* Create a virtual environment:
```bash
python -m venv env
source env/bin/activate
```
* Install dependencies:
```bash
pip install -r requirements.txt
```
* Configure the .env file with your database credentials.
* Run database migrations:
```bash
python manage.py migrate
```
* Start the backend server:
```bash
python manage.py runserver
```
### Frontend Setup (React):
* Navigate to the frontend directory:
```bash
cd ../frontend
```
* Install dependencies:
```bash
npm install
```
* Start the development server:
```bash
npm start
```
### Usage
Open your browser and navigate to `http://localhost:3000`.
Use the intuitive web interface to upload and view DICOM files, explore metadata, or interact with the API.
Refer to the API documentation (/api/docs) for integrating DICOMaestro into your applications.
## Contributing
We welcome contributions from the community! Here's how you can help:
* Report Issues: Use the GitHub issue tracker to report bugs or suggest features.
* Submit Pull Requests: Fork the repository, make your changes, and submit a pull request.
* Improve Documentation: Help us improve the installation and usage guides.
## Guidelines:
Follow the PEP 8 standard for Python code.
Use ESLint to lint JavaScript code.
Ensure your changes are covered by tests.
## License
DICOMaestro is licensed under the MIT License, making it free to use, modify, and distribute. See the LICENSE file for details.
#### Start using DICOMaestro today to simplify your work with medical imaging data!