[](https://github.com/ladybug-tools/honeybee-core/actions)
[](https://coveralls.io/github/ladybug-tools/honeybee-core)
[](https://www.python.org/downloads/release/python-3100/) [](https://www.python.org/downloads/release/python-370/) [](https://www.python.org/downloads/release/python-270/) [](https://github.com/IronLanguages/ironpython2/releases/tag/ipy-2.7.8/)
# honeybee-core
Honeybee is a collection of Python libraries to create representations of buildings
following [honeybee-schema](https://github.com/ladybug-tools/honeybee-schema/wiki).
This package is the core library that provides honeybee's common functionalities.
To extend these functionalities you should install available Honeybee extensions or write
your own.
Here are a number of frequently used extensions for Honeybee:
- [honeybee-radiance](https://github.com/ladybug-tools/honeybee-radiance): Adds daylight simulation to Honeybee.
- [honeybee-energy](https://github.com/ladybug-tools/honeybee-energy): Adds Energy simulation to Honeybee.
- [honeybee-display](https://github.com/ladybug-tools/honeybee-display): Adds VTK visualization to Honeybee.
# Installation
To install the core library use:
`pip install -U honeybee-core`
To check if Honeybee command line interface is installed correctly use `honeybee viz` and you
should get a `viiiiiiiiiiiiizzzzzzzzz!` back in response! :bee:
# [API Documentation](https://www.ladybug.tools/honeybee-core/docs/)
## Local Development
1. Clone this repo locally
```console
git clone git@github.com:ladybug-tools/honeybee-core.git
# or
git clone https://github.com/ladybug-tools/honeybee-core.git
```
2. Install dependencies:
```console
cd honeybee-core
pip install -r dev-requirements.txt
pip install -r requirements.txt
```
3. Run Tests:
```console
python -m pytest ./tests
```
4. Generate Documentation:
```console
sphinx-apidoc -f -e -d 4 -o ./docs ./honeybee
sphinx-build -b html ./docs ./docs/_build/docs
```
Raw data
{
"_id": null,
"home_page": "https://github.com/ladybug-tools/honeybee-core",
"name": "honeybee-core",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": null,
"author": "Ladybug Tools",
"author_email": "info@ladybug.tools",
"download_url": "https://files.pythonhosted.org/packages/40/e1/a372b6f0747ecd4d44734790b9ec35abec74520a1fde0bbddacfc2e9b473/honeybee_core-1.61.30.tar.gz",
"platform": null,
"description": "\n\n[](https://github.com/ladybug-tools/honeybee-core/actions)\n[](https://coveralls.io/github/ladybug-tools/honeybee-core)\n\n[](https://www.python.org/downloads/release/python-3100/) [](https://www.python.org/downloads/release/python-370/) [](https://www.python.org/downloads/release/python-270/) [](https://github.com/IronLanguages/ironpython2/releases/tag/ipy-2.7.8/)\n\n# honeybee-core\n\nHoneybee is a collection of Python libraries to create representations of buildings\nfollowing [honeybee-schema](https://github.com/ladybug-tools/honeybee-schema/wiki).\n\nThis package is the core library that provides honeybee's common functionalities.\nTo extend these functionalities you should install available Honeybee extensions or write\nyour own.\n\nHere are a number of frequently used extensions for Honeybee:\n\n- [honeybee-radiance](https://github.com/ladybug-tools/honeybee-radiance): Adds daylight simulation to Honeybee.\n- [honeybee-energy](https://github.com/ladybug-tools/honeybee-energy): Adds Energy simulation to Honeybee.\n- [honeybee-display](https://github.com/ladybug-tools/honeybee-display): Adds VTK visualization to Honeybee.\n\n\n# Installation\n\nTo install the core library use:\n\n`pip install -U honeybee-core`\n\nTo check if Honeybee command line interface is installed correctly use `honeybee viz` and you\nshould get a `viiiiiiiiiiiiizzzzzzzzz!` back in response! :bee:\n\n# [API Documentation](https://www.ladybug.tools/honeybee-core/docs/)\n\n## Local Development\n1. Clone this repo locally\n```console\ngit clone git@github.com:ladybug-tools/honeybee-core.git\n\n# or\n\ngit clone https://github.com/ladybug-tools/honeybee-core.git\n```\n2. Install dependencies:\n```console\ncd honeybee-core\npip install -r dev-requirements.txt\npip install -r requirements.txt\n```\n\n3. Run Tests:\n```console\npython -m pytest ./tests\n```\n\n4. Generate Documentation:\n```console\nsphinx-apidoc -f -e -d 4 -o ./docs ./honeybee\nsphinx-build -b html ./docs ./docs/_build/docs\n```\n",
"bugtrack_url": null,
"license": "AGPL-3.0",
"summary": "A library to create 3D building geometry for various types of environmental simulation.",
"version": "1.61.30",
"project_urls": {
"Homepage": "https://github.com/ladybug-tools/honeybee-core"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "52c9dc775906e241318e4bc98220c78799ca3d2a49230ab4c6cc1e168050d000",
"md5": "42601314a791b6466a808d7b2fd2cf02",
"sha256": "c0f682912c09a0d0d0d4044eb5d22ce2b97befc1139b8e516a102063741800aa"
},
"downloads": -1,
"filename": "honeybee_core-1.61.30-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "42601314a791b6466a808d7b2fd2cf02",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 178997,
"upload_time": "2025-07-09T21:24:37",
"upload_time_iso_8601": "2025-07-09T21:24:37.186098Z",
"url": "https://files.pythonhosted.org/packages/52/c9/dc775906e241318e4bc98220c78799ca3d2a49230ab4c6cc1e168050d000/honeybee_core-1.61.30-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "40e1a372b6f0747ecd4d44734790b9ec35abec74520a1fde0bbddacfc2e9b473",
"md5": "481f63d877e25cd9104cb7e93c9efaec",
"sha256": "b2d926ed14556677d7fc3c4961d5f2e4ae6e0361e401e1b7e61b672081109d51"
},
"downloads": -1,
"filename": "honeybee_core-1.61.30.tar.gz",
"has_sig": false,
"md5_digest": "481f63d877e25cd9104cb7e93c9efaec",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 366263,
"upload_time": "2025-07-09T21:24:39",
"upload_time_iso_8601": "2025-07-09T21:24:39.085205Z",
"url": "https://files.pythonhosted.org/packages/40/e1/a372b6f0747ecd4d44734790b9ec35abec74520a1fde0bbddacfc2e9b473/honeybee_core-1.61.30.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-09 21:24:39",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ladybug-tools",
"github_project": "honeybee-core",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "ladybug-core",
"specs": [
[
"==",
"0.44.19"
]
]
},
{
"name": "ladybug-geometry-polyskel",
"specs": [
[
"==",
"1.7.30"
]
]
},
{
"name": "honeybee-schema",
"specs": [
[
"==",
"1.59.0"
]
]
}
],
"lcname": "honeybee-core"
}
JSON
