# HACS Core
Core models and base classes for Healthcare Agent Communication Standard (HACS).
## Overview
`hacs-core` provides the foundational models and base classes that all other HACS packages build upon. It defines the core abstractions for healthcare agent communication, including actors, resources, memory management, and evidence handling.
## Key Components
### BaseResource
The foundational class for all HACS resources, providing:
- Unique resource identification
- Metadata management
- Serialization/deserialization
- Validation framework
### Actor
Represents entities that can perform actions in the healthcare system:
- Actor identification and authentication
- Role-based access control
- Audit trail management
- Permission validation
### MemoryBlock
Manages structured memory for healthcare agents:
- Persistent memory storage
- Memory retrieval and querying
- Memory lifecycle management
- Cross-agent memory sharing
### Evidence
Handles clinical evidence and supporting documentation:
- Evidence classification and scoring
- Source attribution and provenance
- Evidence linking and relationships
- Quality assessment metrics
## Installation
```bash
pip install hacs-core
```
## Quick Start
```python
from hacs_core import BaseResource, Actor, MemoryBlock, Evidence
# Create an actor
actor = Actor(
actor_id="dr_smith",
actor_type="clinician",
display_name="Dr. Sarah Smith"
)
# Create a memory block
memory = MemoryBlock(
memory_id="patient_history",
content={"diagnosis": "hypertension"},
actor_context=actor
)
# Create evidence
evidence = Evidence(
evidence_id="guideline_001",
title="Hypertension Management Guidelines",
confidence_score=0.95,
source="American Heart Association"
)
```
## Documentation
For complete documentation, see the [HACS Documentation](https://github.com/solanovisitor/hacs/blob/main/docs/modules/hacs-core.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 Core.
Raw data
{
"_id": null,
"home_page": null,
"name": "hacs-core",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "Solano Todeschini <solano.todeschini@gmail.com>",
"keywords": "actor, agents, ai, base-classes, core, evidence, healthcare, memory, models",
"author": null,
"author_email": "Solano Todeschini <solano.todeschini@gmail.com>",
"download_url": null,
"platform": null,
"description": "# HACS Core\n\nCore models and base classes for Healthcare Agent Communication Standard (HACS).\n\n## Overview\n\n`hacs-core` provides the foundational models and base classes that all other HACS packages build upon. It defines the core abstractions for healthcare agent communication, including actors, resources, memory management, and evidence handling.\n\n## Key Components\n\n### BaseResource\nThe foundational class for all HACS resources, providing:\n- Unique resource identification\n- Metadata management\n- Serialization/deserialization\n- Validation framework\n\n### Actor\nRepresents entities that can perform actions in the healthcare system:\n- Actor identification and authentication\n- Role-based access control\n- Audit trail management\n- Permission validation\n\n### MemoryBlock\nManages structured memory for healthcare agents:\n- Persistent memory storage\n- Memory retrieval and querying\n- Memory lifecycle management\n- Cross-agent memory sharing\n\n### Evidence\nHandles clinical evidence and supporting documentation:\n- Evidence classification and scoring\n- Source attribution and provenance\n- Evidence linking and relationships\n- Quality assessment metrics\n\n## Installation\n\n```bash\npip install hacs-core\n```\n\n## Quick Start\n\n```python\nfrom hacs_core import BaseResource, Actor, MemoryBlock, Evidence\n\n# Create an actor\nactor = Actor(\n actor_id=\"dr_smith\",\n actor_type=\"clinician\",\n display_name=\"Dr. Sarah Smith\"\n)\n\n# Create a memory block\nmemory = MemoryBlock(\n memory_id=\"patient_history\",\n content={\"diagnosis\": \"hypertension\"},\n actor_context=actor\n)\n\n# Create evidence\nevidence = Evidence(\n evidence_id=\"guideline_001\",\n title=\"Hypertension Management Guidelines\",\n confidence_score=0.95,\n source=\"American Heart Association\"\n)\n```\n\n## Documentation\n\nFor complete documentation, see the [HACS Documentation](https://github.com/solanovisitor/hacs/blob/main/docs/modules/hacs-core.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 Core.\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Core models and base classes for Healthcare Agent Communication Standard",
"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/modules/hacs-core.md",
"Homepage": "https://github.com/solanovisitor/hacs",
"Repository": "https://github.com/solanovisitor/hacs"
},
"split_keywords": [
"actor",
" agents",
" ai",
" base-classes",
" core",
" evidence",
" healthcare",
" memory",
" models"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "d39a51866409e3064380891ac021510256a4761494d40c2f75647f7a73beeb54",
"md5": "a694e6b95d3bd0d2b0dd0f5cd17e90ba",
"sha256": "1feb193ee237758d54407a846294064c49a5e711e73c9abf5a3d719c2f1c7184"
},
"downloads": -1,
"filename": "hacs_core-0.2.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a694e6b95d3bd0d2b0dd0f5cd17e90ba",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 14167,
"upload_time": "2025-07-09T14:52:25",
"upload_time_iso_8601": "2025-07-09T14:52:25.488299Z",
"url": "https://files.pythonhosted.org/packages/d3/9a/51866409e3064380891ac021510256a4761494d40c2f75647f7a73beeb54/hacs_core-0.2.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-09 14:52:25",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "solanovisitor",
"github_project": "hacs",
"github_not_found": true,
"lcname": "hacs-core"
}
JSON
