<div align="center">
<img src="https://www.experiment-hq.com/_next/image?url=%2Flogo.png&w=3840&q=75" width="15%" class="center" >
# ExperimentHQ
</div>
ExperimentHQ is a Python package that allows you to track and manage experiments directly from your Python code, and seamlessly sync the results to a Notion database. With ExperimentHQ, you can easily monitor the performance of your models, log custom metrics, and compare experiments with ease, all from a single, intuitive interface.
The purpose of this document is to provide a guide for using ExperimentHQ to track experiments and sync the results to Notion.
## Prerequisites
Before you can use ExperimentHQ, you need to set up the following prerequisites:
1. Set up a Notion account.
2. Set up an [ExperimentHQ](http://www.experiment-hq.com/) account.
3. Connect you Notion account with [ExperimentHQ](http://www.experiment-hq.com/account)
4. Copy your personal API token from [ExperimentHQ](http://www.experiment-hq.com/account)
5. Install ExperimentHQ.
## Installation
To install ExperimentHQ, simply run the following command:
```bash
pip install experimenthq
```
## Usage
### Creating an Experiment
To create an experiment and log it to Notion, you can use the following code snippet as an example:
```python
import experimenthq as ex
experiment = ex.Experiment(
name="My First Experiment",
project="Project A",
api_key="YOUR_API_KEY"
)
experiment.log_parameter("accuracy", 0.85)
experiment.log_parameter("loss", 0.05)
```
This code creates an experiment with the name "My First Experiment" and tags it with the project "Project A". It then logs two parameters, "accuracy" and "loss", with values 0.85 and 0.05 respectively.
### Viewing Experiments in Notion
To view the experiments that you've logged with ExperimentHQ in Notion go to the Notion page that you've linked to ExperimentHQ. You should see a table with the experiments that you've logged.
![Notion Table](https://www.experiment-hq.com/_next/image?url=%2Fnotion_dashboard.png&w=3840&q=75)
## Conclusion
ExperimentHQ provides a simple and intuitive way to track and manage your experiments in Python and sync the results to Notion. By using ExperimentHQ, you can streamline your experiment tracking and make your work more efficient and effective. Try it out today and see the difference it can make in your workflow!
Raw data
{
"_id": null,
"home_page": "",
"name": "experimenthq",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "notion,tracking,ml,machine learning,experiment,experimentation,experiment tracking,python,sync",
"author": "",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/9e/89/fa6009644e80d537e9db055459b51d22e5a2d3e596bd9a4835527a43f4f0/experimenthq-0.2.1.tar.gz",
"platform": null,
"description": "\n\n\n<div align=\"center\">\n\n\n\n<img src=\"https://www.experiment-hq.com/_next/image?url=%2Flogo.png&w=3840&q=75\" width=\"15%\" class=\"center\" >\n\n# ExperimentHQ\n\n</div>\n\n\nExperimentHQ is a Python package that allows you to track and manage experiments directly from your Python code, and seamlessly sync the results to a Notion database. With ExperimentHQ, you can easily monitor the performance of your models, log custom metrics, and compare experiments with ease, all from a single, intuitive interface.\n\nThe purpose of this document is to provide a guide for using ExperimentHQ to track experiments and sync the results to Notion.\n\n## Prerequisites\n\nBefore you can use ExperimentHQ, you need to set up the following prerequisites:\n\n1. Set up a Notion account.\n2. Set up an [ExperimentHQ](http://www.experiment-hq.com/) account.\n3. Connect you Notion account with [ExperimentHQ](http://www.experiment-hq.com/account) \n4. Copy your personal API token from [ExperimentHQ](http://www.experiment-hq.com/account)\n5. Install ExperimentHQ.\n\n## Installation\n\nTo install ExperimentHQ, simply run the following command:\n\n```bash\npip install experimenthq\n```\n\n## Usage\n\n### Creating an Experiment\nTo create an experiment and log it to Notion, you can use the following code snippet as an example:\n\n```python\nimport experimenthq as ex\n\nexperiment = ex.Experiment(\n name=\"My First Experiment\",\n project=\"Project A\",\n api_key=\"YOUR_API_KEY\"\n)\n\nexperiment.log_parameter(\"accuracy\", 0.85)\nexperiment.log_parameter(\"loss\", 0.05)\n\n```\n\nThis code creates an experiment with the name \"My First Experiment\" and tags it with the project \"Project A\". It then logs two parameters, \"accuracy\" and \"loss\", with values 0.85 and 0.05 respectively.\n\n### Viewing Experiments in Notion\n\nTo view the experiments that you've logged with ExperimentHQ in Notion go to the Notion page that you've linked to ExperimentHQ. You should see a table with the experiments that you've logged.\n\n![Notion Table](https://www.experiment-hq.com/_next/image?url=%2Fnotion_dashboard.png&w=3840&q=75)\n\n## Conclusion\nExperimentHQ provides a simple and intuitive way to track and manage your experiments in Python and sync the results to Notion. By using ExperimentHQ, you can streamline your experiment tracking and make your work more efficient and effective. Try it out today and see the difference it can make in your workflow!\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Python package for tracking experiments in Notion",
"version": "0.2.1",
"project_urls": {
"Website": "https://www.experiment-hq.com/"
},
"split_keywords": [
"notion",
"tracking",
"ml",
"machine learning",
"experiment",
"experimentation",
"experiment tracking",
"python",
"sync"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "aff36b314a8dc176086ae11883033ae46d77b80179d75de4f7680d3b454fbd3a",
"md5": "94f12f6066c74e8f26becf80fb0173b4",
"sha256": "3d407f3fde09d5a2b404420668e119b8ff9a2d0470add74b013192fa9a888c35"
},
"downloads": -1,
"filename": "experimenthq-0.2.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "94f12f6066c74e8f26becf80fb0173b4",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 7219,
"upload_time": "2023-06-19T19:12:55",
"upload_time_iso_8601": "2023-06-19T19:12:55.917595Z",
"url": "https://files.pythonhosted.org/packages/af/f3/6b314a8dc176086ae11883033ae46d77b80179d75de4f7680d3b454fbd3a/experimenthq-0.2.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9e89fa6009644e80d537e9db055459b51d22e5a2d3e596bd9a4835527a43f4f0",
"md5": "8f19bcc252e65940aff5f0a3ad352070",
"sha256": "60c35adb95d1e0478d7de82bd1b778cba32d5e0e2d05832f75c79a446f5facb5"
},
"downloads": -1,
"filename": "experimenthq-0.2.1.tar.gz",
"has_sig": false,
"md5_digest": "8f19bcc252e65940aff5f0a3ad352070",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 9071,
"upload_time": "2023-06-19T19:12:57",
"upload_time_iso_8601": "2023-06-19T19:12:57.371531Z",
"url": "https://files.pythonhosted.org/packages/9e/89/fa6009644e80d537e9db055459b51d22e5a2d3e596bd9a4835527a43f4f0/experimenthq-0.2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-06-19 19:12:57",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "experimenthq"
}