hacs-fhir


Namehacs-fhir JSON
Version 0.2.2 PyPI version JSON
download
home_pageNone
SummaryFHIR mapping functionality for HACS
upload_time2025-07-09 14:52:27
maintainerNone
docs_urlNone
authorNone
requires_python>=3.10
licenseApache-2.0
keywords agent communication fhir healthcare mapping
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # 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"
}
        
Elapsed time: 0.55879s