{"id":13590032,"url":"https://github.com/Chemios/chemios","last_synced_at":"2025-04-08T12:32:22.209Z","repository":{"id":45492858,"uuid":"132544164","full_name":"Chemios/chemios","owner":"Chemios","description":"Chemios Framework 👨🏾‍🔬: Accelerating Science through Automation","archived":false,"fork":false,"pushed_at":"2021-12-10T15:25:18.000Z","size":229,"stargazers_count":36,"open_issues_count":0,"forks_count":4,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-01T00:31:20.994Z","etag":null,"topics":["automation","chemyx","harvard-apparatus","high-throughput-screening","iot","laboratory","modbus","omega","pump-control","python","science","syringe-pump"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Chemios.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-05-08T02:45:06.000Z","updated_at":"2024-10-03T23:01:08.000Z","dependencies_parsed_at":"2022-07-15T07:30:34.760Z","dependency_job_id":null,"html_url":"https://github.com/Chemios/chemios","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Chemios%2Fchemios","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Chemios%2Fchemios/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Chemios%2Fchemios/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Chemios%2Fchemios/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Chemios","download_url":"https://codeload.github.com/Chemios/chemios/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247842846,"owners_count":21005355,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","chemyx","harvard-apparatus","high-throughput-screening","iot","laboratory","modbus","omega","pump-control","python","science","syringe-pump"],"created_at":"2024-08-01T16:00:38.071Z","updated_at":"2025-04-08T12:32:21.654Z","avatar_url":"https://github.com/Chemios.png","language":"Python","funding_links":[],"categories":["Software"],"sub_categories":["Workflow Orchestration"],"readme":"![Chemios Framework ReadMe Banner](./assets/framework_readme_banner.jpg)\n\n[![CircleCI](https://circleci.com/gh/Chemios/chemios.svg?style=svg)](https://circleci.com/gh/Chemios/chemios)\n[![Documentation Status](https://readthedocs.org/projects/chemios/badge/?version=latest)](https://chemios.readthedocs.io/en/latest/?badge=latest)\n\n## Contents\n - 👨🏾‍🔬 [Why Chemios?](#why-chemios)\n - 🛠️ [Installation](#installation)\n - 👍 [Examples](#examples)\n - 📋 [Documentation](#documentation)\n - ⚙️ [Compatible Equipment](#features)\n - 🎁 [Contributing](#contributing)\n\n## 👨🏾‍🔬 \u003ca name=\"why-chemios\"\u003e\u003c/a\u003eWhy chemios?\n\n### The Problem\nLaboratories have a lot of equipment—pumps, spectrometers, incubators, etc. One laboratory's equipment is usually worth millions of dollars.\n\nDespite their price tag, these devices rarely have simple software interfaces. So, monitoring them remotely or integrating them into automated experiments is difficult. \n\nWe looked at the existing solutions, and we were not satisfied. Tetrascience is a paid monitoring platform that is [unaffordable for most labs][nature]. Labview has been used to automate lab equipment (see [Epps et al.][epps], [Reizman et al.][reizman], or [Dragone et al.][dragone]). However, LabView licenses cost $5000 annually. ThermoFisher Cloud is the most promising solution, but it only works with a limited number of Thermofisher products.\n\n### The Solution\nThe Chemios Framework is a simple, open-source (i.e. FREE) software package for laboratory automation and monitoring. It is easy-to-use and extensible. It currently works with pumps, spectrometers and temperature controllers. And, the list of equipment will continue to grow (see [Compatible Equipment](#features)) through an open source community. \n\nThe framework is written in python (the unoffical language of science) and actively maintained. We are looking for which equipment to automate next; please [vote][gform] for what equipment you'd like to see with what you would like to see!\n\n## 🛠️\u003ca name=\"installation\"\u003e\u003c/a\u003e Installation\n\nFollow the steps below to design and run your first experiment in minutes.\n\n1. [Install python](https://www.python.org/downloads/) (version 3 or above) if you haven't already. If you are using Windows, it is recommended to install python in the [cygwin](https://cygwin.com/install.html) terminal.\n2. Download this repository (via the green button above) or clone it:\n    ```bash\n    $ git clone https://github.com/Chemios/chemios.git\n    ````\n3. Enter into the root of the repository directory and run:\n    ```bash\n    pip install -e .;pip install -r requirements.txt\n    ```\n\n## 👍 \u003ca name=\"examples\"\u003e\u003c/a\u003e Examples\n\nHere is a how you'd use chemios to run a pump in an automated fashion.\n\n```python\nfrom chemios.pumps import Chemyx\nfrom time import sleep\nimport serial\n\n#Set up serial port for communciation with pump over USB\nser = serial.Serial(port='ttyUSB0', timeout=1, baudrate=9600)\n\n#Connect to a Harvard Apparatus PhD Ultra\nC = Chemyx(model='Phd-Ultra', ser=ser, \n           syringe_manufacturer='Hamilton', syringe_volume=10)\n\n#Set the flowrate to infuse at 100 microliters per minute\nrate = {'value': 100, 'units': 'UM'}                   \nC.set_rate(rate=rate, direction = 'INF')\n\n#Run the pump for 5 seconds\nC.run()\nsleep(5)\n\n#Stop the pump\nC.stop()\n```\n## 📋 \u003ca name=\"documentation\"\u003e\u003c/a\u003e Documentation\n\nYou can find documentation for the chemios framework [here](https://chemios.readthedocs.io/en/latest/?). More examples will be added soon.\n\n## ⚙️ \u003ca name=\"features\"\u003e\u003c/a\u003e Compatible Equipment\n\n- Chemios currently works with the following types of devices:\n     * Syringe Pumps: Harvard Apparatus, Chemyx, and New-Era\n     * Spectrometers: Ocean Optics \n     * Temperature Controllers: Omega CN 9300 Series\n\n- Please [vote][gform] for what equipment you'd like to see with what you would like to see!\n\n- Roadmap:\n     * Finish unit testing syringe pumps (May 2018)\n     * Add create-device script for easily creating a device (May 2018)\n     * Publish package on PyPI (June 2018)\n     * Create experiments module for automating (June 2018)\n     * More to come based on your input.\n\n## 🎁 \u003ca name=\"contributing\"\u003e\u003c/a\u003e Contributing\n\nWe ❤️ contributors! The Chemios Framework came out of a senior design project at [NC State](https://www.ncsu.edu/) and is now maintained by Kobi Felton [@marcosfelt](https://github.com/marcosfelt).\n\nWe are looking in particular for people to extend the framework to work with more types of laboratory equipment. Feel free to [email Kobi](mailto:kobi.c.f@gmail.com) if you're interested.  If you already have some changes, please submit a [pull request](https://gist.github.com/Chaser324/ce0505fbed06b947d962).\n\n[nature]: https://www.nature.com/news/the-internet-of-things-comes-to-the-lab-1.21383?WT.feed_name=subjects_technology#thecostofmonitoring\n[reizman]: https://pubs.acs.org/doi/10.1021/acs.accounts.6b00261\n[dragone]: https://www.nature.com/articles/ncomms15733\n[epps]: http://pubs.rsc.org/en/content/articlelanding/2017/lc/c7lc00884h\n[gform]: https://goo.gl/forms/BS2ZI7HK1Et4CMEl2\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FChemios%2Fchemios","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FChemios%2Fchemios","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FChemios%2Fchemios/lists"}