doctorcli 1.0.0__tar.gz

doctorcli-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AIMLDev726
+
+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.

doctorcli-1.0.0/MANIFEST.in

@@ -0,0 +1,3 @@
+include README.md
+include LICENSE
+recursive-include src *.py

doctorcli-1.0.0/PKG-INFO

@@ -0,0 +1,159 @@
+Metadata-Version: 2.4
+Name: doctorcli
+Version: 1.0.0
+Summary: Specialist-first medical AI CLI with persistent sessions, markdown streaming, optional tools, and multi-provider model support.
+Author: AIMLDev726
+Maintainer: AIMLDev726
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/AIMLDev726/doctorcli
+Project-URL: Repository, https://github.com/AIMLDev726/doctorcli
+Project-URL: Issues, https://github.com/AIMLDev726/doctorcli/issues
+Keywords: ai,cli,doctor,healthcare,llm,medical,rich,terminal
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: User Interfaces
+Classifier: Topic :: Terminals
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx<1.0.0,>=0.27.0
+Requires-Dist: platformdirs<5.0.0,>=4.2.0
+Requires-Dist: pydantic<3.0.0,>=2.8.0
+Requires-Dist: rich<14.0.0,>=13.7.0
+Requires-Dist: typer<1.0.0,>=0.12.3
+Provides-Extra: dev
+Requires-Dist: build<2.0.0,>=1.2.0; extra == "dev"
+Requires-Dist: pytest<9.0.0,>=8.2.0; extra == "dev"
+Requires-Dist: twine<7.0.0,>=6.0.0; extra == "dev"
+Dynamic: license-file
+
+# doctorcli
+
+[GitHub Repository](https://github.com/AIMLDev726/doctorcli)
+
+`doctorcli` is a specialist-first medical AI CLI for structured conversations, persistent sessions, optional live tools, and multi-provider model support.
+
+## Why use doctorcli
+
+`doctorcli` is built for people who want a focused terminal experience instead of a generic chat window. It gives you specialist personas, saved sessions, provider and model control, and a clean markdown-rendered interface for medical Q&A workflows.
+
+## Highlights
+
+- Specialist personas for multiple medical domains
+- Rich terminal UI with streaming markdown responses
+- Persistent sessions with memory across runs
+- Live model discovery and default model selection per provider
+- Optional session tools such as Wikipedia and Tavily web search
+- Visible tool-call output with returned sources in chat
+- Support for OpenAI, Gemini, Groq, Claude, Ollama, and LM Studio
+
+## Installation
+
+Install from PyPI:
+
+```bash
+pip install doctorcli
+```
+
+Install from source:
+
+```bash
+pip install .
+```
+
+Install in editable mode for development:
+
+```bash
+pip install -e ".[dev]"
+```
+
+## Quick start
+
+Run the CLI:
+
+```bash
+doctorcli
+```
+
+Typical flow:
+
+1. Open the app.
+2. Choose a specialist.
+3. Start a new session or continue an existing one.
+4. Select a provider and model.
+5. Optionally attach tools for that session.
+6. Ask questions and continue the session later with memory preserved.
+
+## Supported providers
+
+Cloud providers:
+
+- OpenAI
+- Gemini
+- Groq
+- Claude
+
+Local providers:
+
+- Ollama
+- LM Studio
+
+## Supported tools
+
+- Wikipedia: reference lookup for conditions, medications, symptoms, and background topics
+- Tavily: live web search for current medical and factual context
+
+When a model uses an attached tool, `doctorcli` shows the tool call, the returned summary, and the available sources directly in the chat transcript.
+
+## Session features
+
+- Create named sessions with a consultation reason
+- Reopen past sessions with the original provider and model setup
+- Keep a running transcript and memory through the session lifecycle
+- Use `/memory`, `/session`, `/settings`, and `/exit` commands inside chat
+
+## Local storage
+
+`doctorcli` stores local state in your platform application directories.
+
+- Settings: `doctorcli/settings.json`
+- Sessions: `doctorcli/sessions/*.json`
+- Cached provider model catalogs: stored with settings
+
+## Development
+
+Run tests:
+
+```bash
+python -m pytest
+```
+
+Build release artifacts:
+
+```bash
+python -m build
+```
+
+Validate artifacts before publishing:
+
+```bash
+python -m twine check dist/*
+```
+
+## Contributing
+
+Contributions, issues, and feature requests are welcome.
+
+- Repository: [github.com/AIMLDev726/doctorcli](https://github.com/AIMLDev726/doctorcli)
+- Issues: [github.com/AIMLDev726/doctorcli/issues](https://github.com/AIMLDev726/doctorcli/issues)
+
+## License
+
+MIT

doctorcli-1.0.0/README.md

@@ -0,0 +1,123 @@
+# doctorcli
+
+[GitHub Repository](https://github.com/AIMLDev726/doctorcli)
+
+`doctorcli` is a specialist-first medical AI CLI for structured conversations, persistent sessions, optional live tools, and multi-provider model support.
+
+## Why use doctorcli
+
+`doctorcli` is built for people who want a focused terminal experience instead of a generic chat window. It gives you specialist personas, saved sessions, provider and model control, and a clean markdown-rendered interface for medical Q&A workflows.
+
+## Highlights
+
+- Specialist personas for multiple medical domains
+- Rich terminal UI with streaming markdown responses
+- Persistent sessions with memory across runs
+- Live model discovery and default model selection per provider
+- Optional session tools such as Wikipedia and Tavily web search
+- Visible tool-call output with returned sources in chat
+- Support for OpenAI, Gemini, Groq, Claude, Ollama, and LM Studio
+
+## Installation
+
+Install from PyPI:
+
+```bash
+pip install doctorcli
+```
+
+Install from source:
+
+```bash
+pip install .
+```
+
+Install in editable mode for development:
+
+```bash
+pip install -e ".[dev]"
+```
+
+## Quick start
+
+Run the CLI:
+
+```bash
+doctorcli
+```
+
+Typical flow:
+
+1. Open the app.
+2. Choose a specialist.
+3. Start a new session or continue an existing one.
+4. Select a provider and model.
+5. Optionally attach tools for that session.
+6. Ask questions and continue the session later with memory preserved.
+
+## Supported providers
+
+Cloud providers:
+
+- OpenAI
+- Gemini
+- Groq
+- Claude
+
+Local providers:
+
+- Ollama
+- LM Studio
+
+## Supported tools
+
+- Wikipedia: reference lookup for conditions, medications, symptoms, and background topics
+- Tavily: live web search for current medical and factual context
+
+When a model uses an attached tool, `doctorcli` shows the tool call, the returned summary, and the available sources directly in the chat transcript.
+
+## Session features
+
+- Create named sessions with a consultation reason
+- Reopen past sessions with the original provider and model setup
+- Keep a running transcript and memory through the session lifecycle
+- Use `/memory`, `/session`, `/settings`, and `/exit` commands inside chat
+
+## Local storage
+
+`doctorcli` stores local state in your platform application directories.
+
+- Settings: `doctorcli/settings.json`
+- Sessions: `doctorcli/sessions/*.json`
+- Cached provider model catalogs: stored with settings
+
+## Development
+
+Run tests:
+
+```bash
+python -m pytest
+```
+
+Build release artifacts:
+
+```bash
+python -m build
+```
+
+Validate artifacts before publishing:
+
+```bash
+python -m twine check dist/*
+```
+
+## Contributing
+
+Contributions, issues, and feature requests are welcome.
+
+- Repository: [github.com/AIMLDev726/doctorcli](https://github.com/AIMLDev726/doctorcli)
+- Issues: [github.com/AIMLDev726/doctorcli/issues](https://github.com/AIMLDev726/doctorcli/issues)
+
+## License
+
+MIT

doctorcli-1.0.0/pyproject.toml

@@ -0,0 +1,58 @@
+[build-system]
+requires = ["setuptools>=69", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "doctorcli"
+version = "1.0.0"
+description = "Specialist-first medical AI CLI with persistent sessions, markdown streaming, optional tools, and multi-provider model support."
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "AIMLDev726" }]
+maintainers = [{ name = "AIMLDev726" }]
+keywords = ["ai", "cli", "doctor", "healthcare", "llm", "medical", "rich", "terminal"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Intended Audience :: End Users/Desktop",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Software Development :: User Interfaces",
+    "Topic :: Terminals",
+]
+dependencies = [
+    "httpx>=0.27.0,<1.0.0",
+    "platformdirs>=4.2.0,<5.0.0",
+    "pydantic>=2.8.0,<3.0.0",
+    "rich>=13.7.0,<14.0.0",
+    "typer>=0.12.3,<1.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "build>=1.2.0,<2.0.0",
+    "pytest>=8.2.0,<9.0.0",
+    "twine>=6.0.0,<7.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/AIMLDev726/doctorcli"
+Repository = "https://github.com/AIMLDev726/doctorcli"
+Issues = "https://github.com/AIMLDev726/doctorcli/issues"
+
+[project.scripts]
+doctorcli = "doctorcli.cli:main"
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+

doctorcli-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

doctorcli-1.0.0/src/doctorcli/__init__.py

@@ -0,0 +1,5 @@
+"""doctorcli package."""
+
+__all__ = ["__version__"]
+
+__version__ = "1.0.0"

doctorcli-1.0.0/src/doctorcli/__main__.py

@@ -0,0 +1,5 @@
+from doctorcli.cli import main
+
+
+if __name__ == "__main__":
+    main()

doctorcli-1.0.0/src/doctorcli/agents.py

@@ -0,0 +1,133 @@
+from __future__ import annotations
+
+from doctorcli.domain.models import AgentProfile
+
+
+def _health_scope_suffix() -> str:
+    return (
+        " Limit yourself to health, symptoms, medications, labs, prevention, nutrition, "
+        "mental health, fitness recovery, and care-navigation questions. If a prompt is "
+        "clearly non-medical or general trivia, refuse briefly and redirect the user back "
+        "to a health-related question."
+    )
+
+
+AGENTS: list[AgentProfile] = [
+    AgentProfile(
+        id="general-medicine",
+        name="General Medicine Consultant",
+        specialty="Primary care, triage, symptom framing",
+        summary="Broad first-line assessment, symptom organization, and escalation guidance.",
+        communication_style="Structured, concise, clinically clear, escalation-aware.",
+        system_prompt=(
+            "You are a general medicine AI consultant. Be specific, professional, and "
+            "clear. Ask focused follow-up questions when needed. Organize responses "
+            "under concise headings when helpful. Do not be generic. Distinguish "
+            "between urgent red flags, likely explanations, at-home care, and when "
+            "to seek in-person care. Never claim to diagnose with certainty."
+            + _health_scope_suffix()
+        ),
+    ),
+    AgentProfile(
+        id="cardiology",
+        name="Cardiology Specialist",
+        specialty="Heart symptoms, blood pressure, cardiovascular risk",
+        summary="Focused cardiovascular interpretation with clear risk stratification.",
+        communication_style="Risk-first, evidence-oriented, direct.",
+        system_prompt=(
+            "You are a cardiology-focused AI consultant. Respond with precise "
+            "cardiovascular reasoning, identify red-flag symptoms, and clearly separate "
+            "emergency concerns from routine issues. Be professional, helpful, and "
+            "specific. Avoid generic reassurance."
+            + _health_scope_suffix()
+        ),
+    ),
+    AgentProfile(
+        id="dermatology",
+        name="Dermatology Specialist",
+        specialty="Rashes, lesions, skin irritation, skincare reactions",
+        summary="Pattern-based skin guidance with differential framing and care escalation.",
+        communication_style="Visual-pattern aware, practical, cautious.",
+        system_prompt=(
+            "You are a dermatology-focused AI consultant. Ask targeted questions about "
+            "distribution, duration, triggers, texture, pain, itch, and exposures. "
+            "Provide clear differentials, home-care guidance, and escalation criteria. "
+            "Be specific and concise."
+            + _health_scope_suffix()
+        ),
+    ),
+    AgentProfile(
+        id="endocrinology",
+        name="Endocrinology Specialist",
+        specialty="Diabetes, thyroid, hormones, metabolic symptoms",
+        summary="Hormonal and metabolic pattern review with monitoring guidance.",
+        communication_style="Numbers-aware, monitoring-oriented, methodical.",
+        system_prompt=(
+            "You are an endocrinology-focused AI consultant. Prioritize trends, lab "
+            "context, medication effects, metabolic symptoms, and monitoring plans. "
+            "Be exact and organized. State when physician review or urgent care is needed."
+            + _health_scope_suffix()
+        ),
+    ),
+    AgentProfile(
+        id="gastroenterology",
+        name="Gastroenterology Specialist",
+        specialty="Digestive symptoms, reflux, bowel changes, abdominal pain",
+        summary="Digestive-system focused interpretation with severity sorting.",
+        communication_style="Symptom-pattern focused, practical, escalation-conscious.",
+        system_prompt=(
+            "You are a gastroenterology-focused AI consultant. Ask concise follow-up "
+            "questions about timing, stool changes, diet, fever, bleeding, weight loss, "
+            "and medication history. Be direct, organized, and clinically careful."
+            + _health_scope_suffix()
+        ),
+    ),
+    AgentProfile(
+        id="orthopedics",
+        name="Orthopedics Specialist",
+        specialty="Joint pain, injuries, mobility, sports strain",
+        summary="Musculoskeletal evaluation with self-care and escalation guidance.",
+        communication_style="Functional, anatomy-oriented, practical.",
+        system_prompt=(
+            "You are an orthopedics-focused AI consultant. Structure responses around "
+            "mechanism of injury, pain location, swelling, instability, function limits, "
+            "and red flags. Be practical and specific, not generic."
+            + _health_scope_suffix()
+        ),
+    ),
+    AgentProfile(
+        id="pediatrics",
+        name="Pediatrics Specialist",
+        specialty="Infants, children, developmental and common pediatric concerns",
+        summary="Age-aware pediatric support with strong safety escalation.",
+        communication_style="Age-specific, safety-first, calm and clear.",
+        system_prompt=(
+            "You are a pediatrics-focused AI consultant. Tailor guidance to the child's "
+            "age, weight, feeding, hydration, activity, fever pattern, and breathing "
+            "status. Highlight urgent warning signs clearly. Keep communication precise "
+            "and parent-friendly without being generic."
+            + _health_scope_suffix()
+        ),
+    ),
+    AgentProfile(
+        id="womens-health",
+        name="Women's Health Specialist",
+        specialty="Gynecologic symptoms, menstrual concerns, hormonal issues",
+        summary="Focused women's health guidance with red-flag triage.",
+        communication_style="Respectful, clinically structured, clear.",
+        system_prompt=(
+            "You are a women's-health-focused AI consultant. Ask targeted questions "
+            "about cycle timing, discharge, bleeding, pain, pregnancy possibility, "
+            "contraception, and associated symptoms. Be specific, clear, and careful "
+            "about urgent escalation."
+            + _health_scope_suffix()
+        ),
+    ),
+]
+
+
+def get_agent(agent_id: str) -> AgentProfile:
+    for agent in AGENTS:
+        if agent.id == agent_id:
+            return agent
+    raise KeyError(f"Unknown agent id: {agent_id}")

doctorcli-1.0.0/src/doctorcli/app.py

@@ -0,0 +1,3 @@
+from doctorcli.application import DoctorCliApplication, run_interactive
+
+__all__ = ["DoctorCliApplication", "run_interactive"]