# HACS FHIR
FHIR integration for Healthcare Agent Communication Standard (HACS).
## Overview
`hacs-fhir` provides seamless integration between HACS models and FHIR R5 resources, enabling bidirectional conversion and full interoperability with FHIR-compliant healthcare systems.
## Key Features
### Bidirectional Conversion
- Convert HACS models to FHIR resources
- Convert FHIR resources to HACS models
- Lossless round-trip conversion
- Validation against FHIR specifications
### FHIR R5 Compliance
- Full support for FHIR R5 specification
- Standard resource types and profiles
- Coded values with standard terminologies
- Proper resource relationships and references
### Integration Capabilities
- EHR system integration
- FHIR server connectivity
- Bulk data operations
- Real-time synchronization
## Installation
```bash
pip install hacs-fhir
```
## Quick Start
```python
from hacs_models import Patient, Observation
from hacs_fhir import FHIRConverter
# Create a HACS patient
patient = Patient(
display_name="Jane Smith",
birth_date="1985-03-15",
gender="female"
)
# Convert to FHIR
converter = FHIRConverter()
fhir_patient = converter.to_fhir(patient)
# Convert back to HACS
hacs_patient = converter.from_fhir(fhir_patient)
# Work with observations
observation = Observation(
patient_id=patient.id,
observation_type="blood_pressure",
value={"systolic": 135, "diastolic": 85},
unit="mmHg"
)
fhir_observation = converter.to_fhir(observation)
```
## Supported Resources
### Patient Resources
- Patient demographics and identification
- Contact information and addresses
- Emergency contacts and relationships
- Insurance and coverage information
### Clinical Resources
- Observations (vital signs, lab results)
- Encounters (visits, admissions)
- Conditions and diagnoses
- Medications and prescriptions
### Communication Resources
- Agent messages and communications
- Care team communications
- Patient-provider messaging
- System notifications
## FHIR Server Integration
```python
from hacs_fhir import FHIRClient
# Connect to FHIR server
client = FHIRClient(base_url="https://fhir.example.com")
# Upload HACS data to FHIR server
patient_ref = client.create_patient(patient)
observation_ref = client.create_observation(observation)
# Query FHIR server
patients = client.search_patients(family_name="Smith")
observations = client.get_patient_observations(patient_ref)
```
## 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 FHIR.
Raw data
{
"_id": null,
"home_page": null,
"name": "hacs-fhir",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "Solano Todeschini <solano.todeschini@gmail.com>",
"keywords": "agent, communication, fhir, healthcare, mapping",
"author": null,
"author_email": "Solano Todeschini <solano.todeschini@gmail.com>",
"download_url": null,
"platform": null,
"description": "# HACS FHIR\n\nFHIR integration for Healthcare Agent Communication Standard (HACS).\n\n## Overview\n\n`hacs-fhir` provides seamless integration between HACS models and FHIR R5 resources, enabling bidirectional conversion and full interoperability with FHIR-compliant healthcare systems.\n\n## Key Features\n\n### Bidirectional Conversion\n- Convert HACS models to FHIR resources\n- Convert FHIR resources to HACS models\n- Lossless round-trip conversion\n- Validation against FHIR specifications\n\n### FHIR R5 Compliance\n- Full support for FHIR R5 specification\n- Standard resource types and profiles\n- Coded values with standard terminologies\n- Proper resource relationships and references\n\n### Integration Capabilities\n- EHR system integration\n- FHIR server connectivity\n- Bulk data operations\n- Real-time synchronization\n\n## Installation\n\n```bash\npip install hacs-fhir\n```\n\n## Quick Start\n\n```python\nfrom hacs_models import Patient, Observation\nfrom hacs_fhir import FHIRConverter\n\n# Create a HACS patient\npatient = Patient(\n display_name=\"Jane Smith\",\n birth_date=\"1985-03-15\",\n gender=\"female\"\n)\n\n# Convert to FHIR\nconverter = FHIRConverter()\nfhir_patient = converter.to_fhir(patient)\n\n# Convert back to HACS\nhacs_patient = converter.from_fhir(fhir_patient)\n\n# Work with observations\nobservation = Observation(\n patient_id=patient.id,\n observation_type=\"blood_pressure\",\n value={\"systolic\": 135, \"diastolic\": 85},\n unit=\"mmHg\"\n)\n\nfhir_observation = converter.to_fhir(observation)\n```\n\n## Supported Resources\n\n### Patient Resources\n- Patient demographics and identification\n- Contact information and addresses\n- Emergency contacts and relationships\n- Insurance and coverage information\n\n### Clinical Resources\n- Observations (vital signs, lab results)\n- Encounters (visits, admissions)\n- Conditions and diagnoses\n- Medications and prescriptions\n\n### Communication Resources\n- Agent messages and communications\n- Care team communications\n- Patient-provider messaging\n- System notifications\n\n## FHIR Server Integration\n\n```python\nfrom hacs_fhir import FHIRClient\n\n# Connect to FHIR server\nclient = FHIRClient(base_url=\"https://fhir.example.com\")\n\n# Upload HACS data to FHIR server\npatient_ref = client.create_patient(patient)\nobservation_ref = client.create_observation(observation)\n\n# Query FHIR server\npatients = client.search_patients(family_name=\"Smith\")\nobservations = client.get_patient_observations(patient_ref)\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 FHIR.\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "FHIR mapping functionality for 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": [
"agent",
" communication",
" fhir",
" healthcare",
" mapping"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "6ba4da922160bf5602a63b8fe1068a1e3764a338d1ef64df281f5f0294cc4ff1",
"md5": "67ed205c7d3e6babf1faed0b88041845",
"sha256": "1855e8eb9dc1700e6aec8fbc7c4df7a06c11a3014e3eed439af414e2e4480f2f"
},
"downloads": -1,
"filename": "hacs_fhir-0.2.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "67ed205c7d3e6babf1faed0b88041845",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 8494,
"upload_time": "2025-07-09T14:52:27",
"upload_time_iso_8601": "2025-07-09T14:52:27.855148Z",
"url": "https://files.pythonhosted.org/packages/6b/a4/da922160bf5602a63b8fe1068a1e3764a338d1ef64df281f5f0294cc4ff1/hacs_fhir-0.2.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-09 14:52:27",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "solanovisitor",
"github_project": "hacs",
"github_not_found": true,
"lcname": "hacs-fhir"
}