{"id":13583643,"url":"https://github.com/nullobject/bokeh","last_synced_at":"2025-04-12T08:12:50.388Z","repository":{"id":2790862,"uuid":"3790882","full_name":"nullobject/bokeh","owner":"nullobject","description":"Bokeh is a simple, scalable and blazing-fast task queue built on Node.js and ZeroMQ.","archived":false,"fork":false,"pushed_at":"2019-02-20T00:19:29.000Z","size":334,"stargazers_count":76,"open_issues_count":3,"forks_count":11,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-12T08:12:45.649Z","etag":null,"topics":["javascript","message","queue","zeromq"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/nullobject.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2012-03-21T20:10:30.000Z","updated_at":"2024-12-30T15:24:48.000Z","dependencies_parsed_at":"2022-09-10T13:12:14.739Z","dependency_job_id":null,"html_url":"https://github.com/nullobject/bokeh","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nullobject%2Fbokeh","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nullobject%2Fbokeh/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nullobject%2Fbokeh/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nullobject%2Fbokeh/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nullobject","download_url":"https://codeload.github.com/nullobject/bokeh/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248537144,"owners_count":21120711,"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":["javascript","message","queue","zeromq"],"created_at":"2024-08-01T15:03:40.327Z","updated_at":"2025-04-12T08:12:50.361Z","avatar_url":"https://github.com/nullobject.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"# Bokeh\n\n[![Build Status](https://travis-ci.com/nullobject/bokeh.svg?branch=master)](https://travis-ci.com/nullobject/bokeh)\n\nbokeh (pronounced boh-kay) is a simple, scalable and blazing-fast task queue built on [Node.js](http://nodejs.org) and [ZeroMQ](http://zeromq.org). It allows you to offload tasks from your main application process and distribute them among a pool of workers. Workers can be running on the same host as your application, or scaled out onto multiple machines for greater processing power.\n\nWhen you want a worker to run a task, just submit it to the broker using the client API. A task is simply any class in your application which responds to the `run` method.\n\nBokeh consists of three components:\n\n1. The client library which your application uses to submit tasks to the broker.\n2. The broker process which manages the pool of workers.\n3. The worker processes which are responsible for running tasks.\n\n![](https://raw.githubusercontent.com/nullobject/bokeh/master/logo.png)\n\n## Installation\n\n### ZeroMQ\n\nThe only prerequisite is that you have ZeroMQ installed.\n\n**OS X**\n\nInstall ZeroMQ using brew:\n\n    $ brew install zeromq\n\n**Ubuntu 10.04 LTS**\n\nInstall ZeroMQ using [Chris Lea's PPA](https://launchpad.net/~chris-lea/+archive/zeromq):\n\n    $ sudo add-apt-repository ppa:chris-lea/zeromq\n    $ sudo apt-get update\n    $ sudo apt-get install libzmq-dbg libzmq-dev libzmq1\n\n### Bokeh\n\nInstall Bokeh using npm:\n\n    $ npm install bokeh\n\n## Overview\n\n### Task\n\nA task is a class which responds to the `run` method. A task is dealt to a worker and executed.\n\nOnce the task has been completed, you must call the callback with any data you want to pass back to your application.\n\n    class Reverse\n      run: (data, callback) -\u003e callback null, data.split(\"\").reverse().join(\"\")\n\n### Client\n\nThe client is used by your application to submit tasks to the broker and monitor their progress.\n\n    bokeh = require \"bokeh\"\n    handle = bokeh.getClient().submitTask \"Reverse\", \"hello world\"\n    handle.on \"complete\", (data) -\u003e console.log \"Task %s completed: %s\", handle.id, data\n    handle.on \"error\", (error) -\u003e console.error \"Task %s failed: %s\", handle.id, error\n\n### Broker\n\nThe broker is responsible for routing messages from clients, persisting them to the data store and dealing them to workers.\n\n    bokeh = require \"bokeh\"\n    broker = new bokeh.Broker\n\nBokeh supports pluggable data stores for persisting tasks, currently in-memory, [Redis](http://redis.io/) and [Riak](http://basho.com/products/riak-overview/) are supported.\n\n### Worker\n\nA worker is a process which receives tasks from a broker and executes them. You must register all your task classes with the worker.\n\n    bokeh = require \"bokeh\"\n    worker = new bokeh.Worker\n    worker.registerTask \"Reverse\", require(\"./tasks/reverse\")\n\n## License\n\nBokeh is released under the [MIT license](https://github.com/nullobject/bokeh/blob/master/LICENCE.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnullobject%2Fbokeh","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnullobject%2Fbokeh","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnullobject%2Fbokeh/lists"}