| Name | hacs-cli JSON |
| Version |
0.2.2
JSON |
| download |
| home_page | None |
| Summary | Command-line interface for Healthcare Agent Communication Standard (HACS) |
| upload_time | 2025-07-09 14:52:24 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.10 |
| license | Apache-2.0 |
| keywords |
agents
ai
cli
fhir
healthcare
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# HACS CLI
Command-line interface for Healthcare Agent Communication Standard (HACS).
## Overview
`hacs-cli` provides a comprehensive command-line interface for managing HACS healthcare data, performing CRUD operations, running validations, and integrating with various healthcare systems and agent frameworks.
## Key Features
### Data Management
- Patient, observation, and encounter management
- Bulk data operations and imports
- Data validation and integrity checks
- Export to various formats (JSON, CSV, FHIR)
### Agent Integration
- Agent registration and management
- Message routing and delivery
- Protocol adapter configuration
- Workflow execution and monitoring
### System Operations
- Health checks and diagnostics
- Performance monitoring
- Configuration management
- Database operations
## Installation
```bash
pip install hacs-cli
```
## Quick Start
### Basic Commands
```bash
# Get help
hacs --help
# Create a patient
hacs patient create --name "John Doe" --birth-date "1980-01-01" --gender "male"
# List patients
hacs patient list
# Get patient details
hacs patient get --id PATIENT_ID
# Create observation
hacs observation create --patient-id PATIENT_ID --type "blood_pressure" --value "120/80" --unit "mmHg"
# List observations for a patient
hacs observation list --patient-id PATIENT_ID
```
### Bulk Operations
```bash
# Import patients from CSV
hacs patient import --file patients.csv --format csv
# Export patients to JSON
hacs patient export --format json --output patients.json
# Bulk create observations
hacs observation import --file observations.json --format json
```
## Commands Reference
### Patient Management
```bash
# Create patient
hacs patient create --name "Jane Smith" --birth-date "1985-03-15"
# Update patient
hacs patient update --id PATIENT_ID --name "Jane Smith-Jones"
# Delete patient
hacs patient delete --id PATIENT_ID
# Search patients
hacs patient search --query "hypertension" --limit 10
```
### Observation Management
```bash
# Create observation
hacs observation create \
--patient-id PATIENT_ID \
--type "vital_signs" \
--value '{"systolic": 120, "diastolic": 80}' \
--unit "mmHg"
# List observations
hacs observation list --patient-id PATIENT_ID --type "blood_pressure"
# Update observation
hacs observation update --id OBS_ID --value '{"systolic": 125, "diastolic": 82}'
```
### Agent Operations
```bash
# Register agent
hacs agent register --id "dr_smith" --type "clinician" --name "Dr. Sarah Smith"
# Send message
hacs agent message send \
--from "dr_smith" \
--to "nurse_jones" \
--content "Patient needs follow-up" \
--type "clinical_note"
# List messages
hacs agent message list --agent-id "dr_smith"
```
### System Operations
```bash
# Health check
hacs system health
# Database status
hacs system db status
# Run migrations
hacs system db migrate
# Performance metrics
hacs system metrics
# Configuration
hacs system config show
hacs system config set --key "api.timeout" --value "30"
```
## Configuration
### Configuration File
Create `~/.hacs/config.yaml`:
```yaml
database:
url: postgresql://user:pass@localhost/hacs
api:
base_url: http://localhost:8000
timeout: 30
auth:
token: your-api-token
logging:
level: INFO
file: ~/.hacs/logs/hacs.log
```
### Environment Variables
```bash
export HACS_DATABASE_URL=postgresql://user:pass@localhost/hacs
export HACS_API_BASE_URL=http://localhost:8000
export HACS_AUTH_TOKEN=your-token
export HACS_LOG_LEVEL=INFO
```
## Integration Examples
### FHIR Integration
```bash
# Export to FHIR format
hacs patient export --format fhir --output patients.fhir.json
# Import from FHIR server
hacs patient import --fhir-server https://fhir.example.com --format fhir
```
### Agent Framework Integration
```bash
# Start MCP adapter
hacs adapter mcp start --port 8080
# Configure LangGraph workflow
hacs adapter langgraph configure --workflow clinical_assessment
# Run CrewAI integration
hacs adapter crewai run --crew medical_team --input patient_data.json
```
## Scripting and Automation
### Batch Processing
```bash
#!/bin/bash
# Process multiple patients
for patient_file in patients/*.json; do
hacs patient import --file "$patient_file" --format json
done
```
### Monitoring Script
```bash
#!/bin/bash
# Health monitoring
hacs system health --format json | jq '.status'
hacs system metrics --format json | jq '.memory_usage'
```
## Documentation
For complete documentation, see the [HACS Documentation](https://github.com/solanovisitor/hacs/blob/main/docs/README.md).
## License
Licensed under the Apache License, Version 2.0. See [LICENSE](https://github.com/solanovisitor/hacs/blob/main/LICENSE) for details.
## Contributing
See [Contributing Guidelines](https://github.com/solanovisitor/hacs/blob/main/docs/contributing/guidelines.md) for information on how to contribute to HACS CLI.
Raw data
{
"_id": null,
"home_page": null,
"name": "hacs-cli",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "Solano Todeschini <solano.todeschini@gmail.com>",
"keywords": "agents, ai, cli, fhir, healthcare",
"author": null,
"author_email": "Solano Todeschini <solano.todeschini@gmail.com>",
"download_url": null,
"platform": null,
"description": "# HACS CLI\n\nCommand-line interface for Healthcare Agent Communication Standard (HACS).\n\n## Overview\n\n`hacs-cli` provides a comprehensive command-line interface for managing HACS healthcare data, performing CRUD operations, running validations, and integrating with various healthcare systems and agent frameworks.\n\n## Key Features\n\n### Data Management\n- Patient, observation, and encounter management\n- Bulk data operations and imports\n- Data validation and integrity checks\n- Export to various formats (JSON, CSV, FHIR)\n\n### Agent Integration\n- Agent registration and management\n- Message routing and delivery\n- Protocol adapter configuration\n- Workflow execution and monitoring\n\n### System Operations\n- Health checks and diagnostics\n- Performance monitoring\n- Configuration management\n- Database operations\n\n## Installation\n\n```bash\npip install hacs-cli\n```\n\n## Quick Start\n\n### Basic Commands\n```bash\n# Get help\nhacs --help\n\n# Create a patient\nhacs patient create --name \"John Doe\" --birth-date \"1980-01-01\" --gender \"male\"\n\n# List patients\nhacs patient list\n\n# Get patient details\nhacs patient get --id PATIENT_ID\n\n# Create observation\nhacs observation create --patient-id PATIENT_ID --type \"blood_pressure\" --value \"120/80\" --unit \"mmHg\"\n\n# List observations for a patient\nhacs observation list --patient-id PATIENT_ID\n```\n\n### Bulk Operations\n```bash\n# Import patients from CSV\nhacs patient import --file patients.csv --format csv\n\n# Export patients to JSON\nhacs patient export --format json --output patients.json\n\n# Bulk create observations\nhacs observation import --file observations.json --format json\n```\n\n## Commands Reference\n\n### Patient Management\n```bash\n# Create patient\nhacs patient create --name \"Jane Smith\" --birth-date \"1985-03-15\"\n\n# Update patient\nhacs patient update --id PATIENT_ID --name \"Jane Smith-Jones\"\n\n# Delete patient\nhacs patient delete --id PATIENT_ID\n\n# Search patients\nhacs patient search --query \"hypertension\" --limit 10\n```\n\n### Observation Management\n```bash\n# Create observation\nhacs observation create \\\n --patient-id PATIENT_ID \\\n --type \"vital_signs\" \\\n --value '{\"systolic\": 120, \"diastolic\": 80}' \\\n --unit \"mmHg\"\n\n# List observations\nhacs observation list --patient-id PATIENT_ID --type \"blood_pressure\"\n\n# Update observation\nhacs observation update --id OBS_ID --value '{\"systolic\": 125, \"diastolic\": 82}'\n```\n\n### Agent Operations\n```bash\n# Register agent\nhacs agent register --id \"dr_smith\" --type \"clinician\" --name \"Dr. Sarah Smith\"\n\n# Send message\nhacs agent message send \\\n --from \"dr_smith\" \\\n --to \"nurse_jones\" \\\n --content \"Patient needs follow-up\" \\\n --type \"clinical_note\"\n\n# List messages\nhacs agent message list --agent-id \"dr_smith\"\n```\n\n### System Operations\n```bash\n# Health check\nhacs system health\n\n# Database status\nhacs system db status\n\n# Run migrations\nhacs system db migrate\n\n# Performance metrics\nhacs system metrics\n\n# Configuration\nhacs system config show\nhacs system config set --key \"api.timeout\" --value \"30\"\n```\n\n## Configuration\n\n### Configuration File\nCreate `~/.hacs/config.yaml`:\n```yaml\ndatabase:\n url: postgresql://user:pass@localhost/hacs\n \napi:\n base_url: http://localhost:8000\n timeout: 30\n \nauth:\n token: your-api-token\n \nlogging:\n level: INFO\n file: ~/.hacs/logs/hacs.log\n```\n\n### Environment Variables\n```bash\nexport HACS_DATABASE_URL=postgresql://user:pass@localhost/hacs\nexport HACS_API_BASE_URL=http://localhost:8000\nexport HACS_AUTH_TOKEN=your-token\nexport HACS_LOG_LEVEL=INFO\n```\n\n## Integration Examples\n\n### FHIR Integration\n```bash\n# Export to FHIR format\nhacs patient export --format fhir --output patients.fhir.json\n\n# Import from FHIR server\nhacs patient import --fhir-server https://fhir.example.com --format fhir\n```\n\n### Agent Framework Integration\n```bash\n# Start MCP adapter\nhacs adapter mcp start --port 8080\n\n# Configure LangGraph workflow\nhacs adapter langgraph configure --workflow clinical_assessment\n\n# Run CrewAI integration\nhacs adapter crewai run --crew medical_team --input patient_data.json\n```\n\n## Scripting and Automation\n\n### Batch Processing\n```bash\n#!/bin/bash\n# Process multiple patients\nfor patient_file in patients/*.json; do\n hacs patient import --file \"$patient_file\" --format json\ndone\n```\n\n### Monitoring Script\n```bash\n#!/bin/bash\n# Health monitoring\nhacs system health --format json | jq '.status'\nhacs system metrics --format json | jq '.memory_usage'\n```\n\n## Documentation\n\nFor complete documentation, see the [HACS Documentation](https://github.com/solanovisitor/hacs/blob/main/docs/README.md).\n\n## License\n\nLicensed under the Apache License, Version 2.0. See [LICENSE](https://github.com/solanovisitor/hacs/blob/main/LICENSE) for details.\n\n## Contributing\n\nSee [Contributing Guidelines](https://github.com/solanovisitor/hacs/blob/main/docs/contributing/guidelines.md) for information on how to contribute to HACS CLI.\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Command-line interface for Healthcare Agent Communication Standard (HACS)",
"version": "0.2.2",
"project_urls": {
"Bug Tracker": "https://github.com/solanovisitor/hacs/issues",
"Changelog": "https://github.com/solanovisitor/hacs/blob/main/docs/reference/changelog.md",
"Documentation": "https://github.com/solanovisitor/hacs/blob/main/docs/README.md",
"Homepage": "https://github.com/solanovisitor/hacs",
"Repository": "https://github.com/solanovisitor/hacs"
},
"split_keywords": [
"agents",
" ai",
" cli",
" fhir",
" healthcare"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "22fe0f3eac37fda3cb1d935c2b6d4e65bbae3f3d6ce49d82f5f1501b5f2b2d58",
"md5": "75ad40452733fa8a31701ddecf14d11d",
"sha256": "0491a31606fd3ec11e7a9c9754d45d66d6882aaa27bf7e5ea05914b9378ae7ae"
},
"downloads": -1,
"filename": "hacs_cli-0.2.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "75ad40452733fa8a31701ddecf14d11d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 12007,
"upload_time": "2025-07-09T14:52:24",
"upload_time_iso_8601": "2025-07-09T14:52:24.521539Z",
"url": "https://files.pythonhosted.org/packages/22/fe/0f3eac37fda3cb1d935c2b6d4e65bbae3f3d6ce49d82f5f1501b5f2b2d58/hacs_cli-0.2.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-09 14:52:24",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "solanovisitor",
"github_project": "hacs",
"github_not_found": true,
"lcname": "hacs-cli"
}
