coregrai 2.0.0__py3-none-any.whl

coregrai-2.0.0.dist-info/METADATA

@@ -0,0 +1,455 @@
+Metadata-Version: 2.4
+Name: coregrai
+Version: 2.0.0
+Summary: AI-powered study assistant for the ACR Core Exam and diagnostic radiology
+Home-page: https://coregrai.com
+Author: GRAi Team
+Author-email: GRAi Team <support@coregrai.com>
+License-Expression: MIT
+Project-URL: Homepage, https://coregrai.com
+Project-URL: Documentation, https://docs.coregrai.com
+Project-URL: Repository, https://github.com/coregrai/grai-cli
+Project-URL: Changelog, https://github.com/coregrai/grai-cli/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/coregrai/grai-cli/issues
+Keywords: radiology,medical,education,ACR,exam,study,AI,differential-diagnosis
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Healthcare Industry
+Classifier: Intended Audience :: Education
+Classifier: Topic :: Education
+Classifier: Topic :: Scientific/Engineering :: Medical Science Apps.
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0.0
+Requires-Dist: requests>=2.28.0
+Requires-Dist: rich>=13.0.0
+Provides-Extra: secure
+Requires-Dist: keyring>=23.0.0; extra == "secure"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: flake8>=6.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: build>=1.0.0; extra == "dev"
+Requires-Dist: twine>=4.0.0; extra == "dev"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# GRAi CLI
+
+> AI-powered study assistant for the ACR Core Exam and diagnostic radiology
+
+[![PyPI version](https://badge.fury.io/py/grai-cli.svg)](https://badge.fury.io/py/grai-cli)
+[![Python Versions](https://img.shields.io/pypi/pyversions/grai-cli.svg)](https://pypi.org/project/grai-cli/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Overview
+
+GRAi CLI brings the power of AI-assisted radiology education to your terminal. Study for the ACR Core Exam with interactive chat, practice quizzes, and comprehensive lessons - all from the command line.
+
+### Features
+
+- **Interactive Chat**: Ask questions about any radiology topic and get AI-powered explanations
+- **Practice Quizzes**: Board-style questions with adaptive difficulty
+- **Comprehensive Lessons**: 572+ pre-generated lessons covering all ACR topics
+- **Progress Tracking**: Monitor your study statistics and performance
+- **Offline Export**: Save lessons to markdown files for offline study
+- **Beautiful Terminal UI**: Rich, colorful interface with syntax highlighting
+
+## Installation
+
+### From PyPI (Recommended)
+
+```bash
+pip install grai-cli
+```
+
+### From Source
+
+```bash
+git clone https://github.com/yourusername/grai-cli.git
+cd grai-cli
+pip install -e .
+```
+
+### Requirements
+
+- Python 3.8 or higher
+- Active internet connection (for API access)
+- GRAi account (free registration at https://coregrai.com)
+
+## Quick Start
+
+### 1. Login
+
+```bash
+grai login
+```
+
+You'll be prompted for your email and password. Don't have an account? Register at https://coregrai.com
+
+### 2. Ask Questions
+
+```bash
+# Single question
+grai chat "What are the CT findings in pulmonary embolism?"
+
+# Interactive chat session
+grai chat -i
+```
+
+### 3. Take a Quiz
+
+```bash
+# Random quiz (5 questions)
+grai quiz
+
+# Topic-specific quiz
+grai quiz --topic chest-ct --count 10
+
+# Adaptive difficulty based on your performance
+grai quiz --adaptive
+```
+
+### 4. Study Lessons
+
+```bash
+# List all available lessons
+grai lesson --list
+
+# Search for lessons
+grai lesson --search "cardiac"
+
+# Read a specific lesson
+grai lesson chest-radiography-basics
+```
+
+### 5. Check Your Progress
+
+```bash
+grai stats
+```
+
+## Usage Guide
+
+### Chat Commands
+
+**Single Query:**
+```bash
+grai chat "Explain MRI sequences"
+```
+
+**Interactive Mode:**
+```bash
+grai chat -i
+```
+
+**With Sources:**
+```bash
+grai chat --sources "What is the ACR TI-RADS classification?"
+```
+
+**Specify Model:**
+```bash
+grai chat --model gemini "Describe CT protocols"
+```
+
+### Quiz Commands
+
+**Basic Quiz:**
+```bash
+grai quiz
+```
+
+**Topic-Specific:**
+```bash
+# Available topics: chest-xray, chest-ct, neuro-ct, neuro-mri,
+# abdominal-ct, abdominal-mri, msk, nuclear-medicine, ultrasound, etc.
+grai quiz --topic neuro-mri
+```
+
+**Set Difficulty:**
+```bash
+grai quiz --difficulty hard --count 10
+```
+
+**Adaptive Mode:**
+```bash
+# Questions adjust based on your performance
+grai quiz --adaptive
+```
+
+### Lesson Commands
+
+**List Lessons:**
+```bash
+grai lesson --list
+```
+
+**Search Lessons:**
+```bash
+grai lesson --search "mri"
+grai lesson --search "cardiac" --category cardiothoracic
+```
+
+**Read a Lesson:**
+```bash
+grai lesson chest-radiography-basics
+```
+
+**Export Lesson:**
+```bash
+grai export chest-radiography-basics --output ~/study/chest.md
+```
+
+### Configuration
+
+**Show Current Config:**
+```bash
+grai config --show
+```
+
+**Change Server URL:**
+```bash
+grai config --server https://your-server.com
+```
+
+**View Statistics:**
+```bash
+grai stats
+```
+
+**Logout:**
+```bash
+grai logout
+```
+
+## Advanced Usage
+
+### Custom Server
+
+If you're running your own GRAi instance:
+
+```bash
+grai config --server http://localhost:5000
+grai login
+```
+
+### Batch Operations
+
+Study multiple topics in sequence:
+
+```bash
+# Create a study script
+#!/bin/bash
+grai quiz --topic chest-ct --count 5
+grai quiz --topic chest-xray --count 5
+grai quiz --topic neuro-ct --count 5
+grai stats
+```
+
+### Export Study Materials
+
+Export all cardiothoracic lessons:
+
+```bash
+#!/bin/bash
+for lesson in $(grai lesson --list --category cardiothoracic | grep -oP '^\S+'); do
+    grai export "$lesson" --output "study/${lesson}.md"
+done
+```
+
+## Configuration File
+
+GRAi CLI stores configuration in `~/.grai/config.json`:
+
+```json
+{
+  "server_url": "https://coregrai.com",
+  "default_model": "deepseek",
+  "show_sources": false,
+  "color_output": true,
+  "auth_token": "<your-token>",
+  "user_email": "your@email.com"
+}
+```
+
+## Features in Detail
+
+### Interactive Chat
+
+The interactive chat mode provides a conversational interface:
+
+```
+> You: What causes pneumothorax on chest x-ray?
+
+GRAi: Pneumothorax appears on chest radiographs as...
+[detailed explanation with key findings]
+
+Sources:
+  1. Chest Radiography Fundamentals
+  2. Emergency Radiology - Pneumothorax
+  3. ACR Appropriateness Criteria
+
+> You: How do you measure it?
+...
+```
+
+### Practice Quizzes
+
+Board-style questions with immediate feedback:
+
+```
+Question 1/10:
+A 45-year-old male presents with chest pain...
+Which finding is most concerning?
+
+  1. Cardiomegaly
+  2. Pleural effusion
+  3. Pneumomediastinum
+  4. Atelectasis
+
+Your answer: 3
+
+Correct! Pneumomediastinum in the setting of chest pain
+may indicate esophageal perforation, which requires urgent
+evaluation.
+```
+
+### Progress Tracking
+
+Monitor your improvement:
+
+```
+Your Study Statistics
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Questions Answered    847
+Lessons Completed     42
+Study Streak          14 days
+Average Score         84.5%
+Total Study Time      23h 15m
+
+Areas to Focus On:
+  - Nuclear Medicine Physics
+  - Interventional Radiology
+  - Ultrasound Artifacts
+```
+
+## Troubleshooting
+
+### Connection Issues
+
+```bash
+# Check server connectivity
+curl https://coregrai.com/api/health
+
+# Try alternative server
+grai config --server https://backup.coregrai.com
+```
+
+### Authentication Problems
+
+```bash
+# Re-login
+grai logout
+grai login
+```
+
+### Clear Configuration
+
+```bash
+# Remove config file
+rm ~/.grai/config.json
+
+# Login again
+grai login
+```
+
+## Development
+
+### Setup Development Environment
+
+```bash
+git clone https://github.com/yourusername/grai-cli.git
+cd grai-cli
+python -m venv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+pip install -r requirements-dev.txt
+pip install -e .
+```
+
+### Run Tests
+
+```bash
+pytest
+pytest --cov=grai_cli
+```
+
+### Code Formatting
+
+```bash
+black grai_cli/
+flake8 grai_cli/
+```
+
+### Build Package
+
+```bash
+python -m build
+twine check dist/*
+```
+
+### Publish to PyPI
+
+```bash
+# Test PyPI
+twine upload --repository testpypi dist/*
+
+# Production PyPI
+twine upload dist/*
+```
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
+3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
+4. Push to the branch (`git push origin feature/AmazingFeature`)
+5. Open a Pull Request
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Support
+
+- **Documentation**: https://docs.coregrai.com
+- **Issues**: https://github.com/yourusername/grai-cli/issues
+- **Email**: support@coregrai.com
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md) for a list of changes.
+
+## Acknowledgments
+
+- Built with [Click](https://click.palletsprojects.com/)
+- Beautiful terminal output powered by [Rich](https://rich.readthedocs.io/)
+- ACR content based on official ACR guidelines and appropriateness criteria
+
+---
+
+**Made with ❤️ for radiology residents everywhere**

coregrai-2.0.0.dist-info/RECORD

@@ -0,0 +1,12 @@
+coregrai-2.0.0.dist-info/licenses/LICENSE,sha256=nDSoZ7aXIrx2Ei9YgwtmYPy3u0UvaPYO7_L-yfPNECY,1087
+grai_cli/__init__.py,sha256=S9QJvY87bXYFTSLxPQRkYSJ740cHUxiZp6HxP3Q8LrI,1529
+grai_cli/__main__.py,sha256=7sbobcqXuIuhPRY_ye1vzg6Jk_P4fvI0gOODs7ENklo,174
+grai_cli/auth.py,sha256=HzsTSARz9QD_hg4iQzLLN79jsf7cN1O_MV20FfLB0N0,2391
+grai_cli/cli.py,sha256=MVB89rqztxrB-dT1TBtDzKzdH5CJbLT8jrNJAGyKNeM,20881
+grai_cli/client.py,sha256=-ko18X8eGgLR0JZz6vr0k-DOclbkU2RYBEDGw2V_hQI,7902
+grai_cli/config.py,sha256=UkQOJOVumvsLWFcYAp3N8_p09p-UBF514-TV3lyCUII,2023
+coregrai-2.0.0.dist-info/METADATA,sha256=YK17PIAgYgV6lE02dYIwmQGXFmfgqIKyBP8xtgiiDzY,9977
+coregrai-2.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+coregrai-2.0.0.dist-info/entry_points.txt,sha256=bdyTzcZdwIyAL_CGrJR4qujOE0p-w_AUmka4WwyT_L4,43
+coregrai-2.0.0.dist-info/top_level.txt,sha256=JfIomgA4AYIJ1Uz5xwvrre6ERYONhbeGxt74gqAdf8M,9
+coregrai-2.0.0.dist-info/RECORD,,

coregrai-2.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

coregrai-2.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+grai = grai_cli.cli:main

coregrai-2.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 GRAi Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

coregrai-2.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+grai_cli

grai_cli/__init__.py

@@ -0,0 +1,54 @@
+"""
+GRAi CLI - Command-line interface for Diagnostic Radiology AI Assistant
+
+A powerful command-line tool for radiology residents preparing for the ACR Core Exam.
+Features include AI-powered chat, practice quizzes, comprehensive lessons, and
+differential diagnosis generation.
+"""
+
+__version__ = "2.0.0"
+__author__ = "GRAi Team"
+__email__ = "support@coregrai.com"
+__description__ = "AI-powered study assistant for the ACR Core Exam and diagnostic radiology"
+
+
+def __getattr__(name):
+    """Lazy import for public API."""
+    if name == "main":
+        from .cli import main
+        return main
+    elif name == "cli":
+        from .cli import cli
+        return cli
+    elif name == "GraiClient":
+        from .client import GraiClient
+        return GraiClient
+    elif name == "Config":
+        from .config import Config
+        return Config
+    elif name == "authenticate":
+        from .auth import authenticate
+        return authenticate
+    elif name == "logout":
+        from .auth import logout
+        return logout
+    elif name == "check_auth":
+        from .auth import check_auth
+        return check_auth
+    elif name == "get_current_user":
+        from .auth import get_current_user
+        return get_current_user
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
+__all__ = [
+    "main",
+    "cli",
+    "GraiClient",
+    "Config",
+    "authenticate",
+    "logout",
+    "check_auth",
+    "get_current_user",
+    "__version__",
+]

grai_cli/__main__.py

@@ -0,0 +1,11 @@
+#!/usr/bin/env python3
+"""
+GRAi CLI entry point
+
+Allows running with: python -m grai_cli
+"""
+
+from grai_cli.cli import main
+
+if __name__ == '__main__':
+    main()

grai_cli/auth.py

@@ -0,0 +1,93 @@
+"""
+Authentication handling for GRAi CLI
+"""
+
+import requests
+from typing import Tuple
+
+
+def authenticate(config, email: str, password: str) -> Tuple[bool, str]:
+    """
+    Authenticate user with email and password
+
+    Args:
+        config: Configuration object
+        email: User email
+        password: User password
+
+    Returns:
+        Tuple of (success, message)
+    """
+    server_url = config.get('server_url', 'https://coregrai.com')
+    url = f"{server_url}/api/auth/login"
+
+    try:
+        response = requests.post(url, json={
+            'email': email,
+            'password': password
+        })
+
+        if response.status_code == 200:
+            data = response.json()
+            if data.get('success'):
+                token = data.get('token')
+                user = data.get('user', {})
+
+                # Save credentials
+                config.set('auth_token', token)
+                config.set('user_email', user.get('email'))
+                config.set('user_name', user.get('username'))
+
+                return True, "Login successful"
+
+        # Login failed
+        error_data = response.json() if response.headers.get('content-type', '').startswith('application/json') else {}
+        error_msg = error_data.get('error', 'Invalid credentials')
+        return False, error_msg
+
+    except requests.exceptions.ConnectionError:
+        return False, "Could not connect to server"
+    except Exception as e:
+        return False, f"Authentication error: {str(e)}"
+
+
+def logout(config) -> None:
+    """
+    Log out user by clearing credentials
+
+    Args:
+        config: Configuration object
+    """
+    config.delete('auth_token')
+    config.delete('user_email')
+    config.delete('user_name')
+
+
+def check_auth(config) -> bool:
+    """
+    Check if user is authenticated
+
+    Args:
+        config: Configuration object
+
+    Returns:
+        True if authenticated, False otherwise
+    """
+    return config.get('auth_token') is not None
+
+
+def get_current_user(config) -> dict:
+    """
+    Get current authenticated user info
+
+    Args:
+        config: Configuration object
+
+    Returns:
+        User info dictionary
+    """
+    return {
+        'email': config.get('user_email'),
+        'name': config.get('user_name'),
+        'token': config.get('auth_token')
+    }