Skip to main content
Help improve PyPI by participating in a 5-minute user interface survey!

A Python project that adds real time streaming to your web app's data.

Project Description



Oneline is a websockets project that aims to simplifies writing client/server
socket code for ws, additionally provides layer of database. It is
made for developers who wish to experiment with the websocket standard
while trying to build practical applications.

How It works

It uses ws4py and cherrypy in processing websocket things, the frontend
client written in javascript is the connection to web applications. The server is designed to handle it's client.


To install oneline, you can download the code on PyPi or even GitHub (,

currently to run this, use


on success you should see the oneline server startup.


There's some recipes for Oneline, they demonstrate its pragmatic
usage in web applications or broker servers, currently they are (as of this writing)

Example 1:
LastFM Tag Streamer
- This example demonstrates streaming artists and music according to their
socially voted tags. The dataset, publicly available can be found @

Example 2:
Catapult Call Streaming
- Websockets with telecom info, this will show how to
stream VoIP events, calls using oneline and Catapult's RESTful
API, documentation.

Example 3:
Wikipedia PageRank
- This application, will use PIG and Hadoop MapReduce in providing
a realtime pagerank for wiki articles, articles which are scored
with a dampening factor of 0.08 can be voted up or down

All recipes are available at

Object Documentation
Geo Object
used to calculate lat,lng coords, bidrectionally or
in one.
meet time ranged events
General purpose SQL queries
Get input of sound based events
use oneline without a database connection

Technical Supports, requirements

Python Support:

currently >= 2.7 is needed

Databases, as of this writing supports:

PostGreSQL, MySQL, SQLite, CouchDB and MongoDB

It is recommended to atleast have one database connection

Old news ----------------------------------------------------------------------

Older Description:
A Python project that adds real time streaming to your web app's data.
Streaming is done through server modules which are written
in python, these will then be streamed over websockets -- using
cherrypy and ws4py. Streaming is done with a db table, which
will be used for all the module's data.

Data can be refined in a few ways. Currently, it is done
through the defined modules, geolocation and event.
The former will refine data based on geolocation(lng, lat) coordinates.
The latter is a general purpose database querier. These objects
can be used through a non commutative pipeline which
will filter data according to your needs.

Release history Release notifications

History Node


This version
History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
oneline-0.6.4-alpha.tar.gz (21.6 MB) Copy SHA256 hash SHA256 Source None Mar 29, 2015 (11.5 MB) Copy SHA256 hash SHA256 Source None Nov 24, 2015

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page