Installation

oso is available as a library in several languages:

Python

Ruby

Java

Node.js

Rust

The Python version of oso is available on PyPI and can be installed using pip:

$ pip install oso==0.7.0

The Python version is known to work on glibc-based distributions but not on musl-based ones (like Alpine Linux). Wheels built against musl that you can use on Alpine Linux can be downloaded from the releases page on GitHub.

For more information on the oso Python library, see the library documentation.

To use or install the oso Flask integration, see Flask.

To use or install the oso Django integration, see Django.

What’s next

After you’ve installed oso, check out the Quickstart.

Requirements

  • Python version 3.6 or greater

  • Supported platforms:

    • Linux

    • OS X

    • Windows

The Ruby version of oso is available on RubyGems and can be installed into your local Ruby:

$ gem install oso-oso -v 0.7.0

or added to a project’s Gemfile:

gem 'oso-oso', '~> 0.7.0'

For more information on the oso Ruby library, see the library documentation.

What’s next

After you’ve installed oso, check out the Quickstart.

Requirements

  • Ruby version 2.4 or greater

  • Supported platforms:

    • Linux

    • OS X

    • Windows

The Java version of oso is available on Maven Central.

It can be added as a dependency to a Maven project:

<!-- https://mvnrepository.com/artifact/com.osohq/oso -->
<dependency>
    <groupId>com.osohq</groupId>
    <artifactId>oso</artifactId>
    <version>0.7.0</version>
</dependency>

or a Gradle project:

// https://mvnrepository.com/artifact/com.osohq/oso
compile group: 'com.osohq', name: 'oso', version: '{relase}'

or downloaded as a JAR and added to the classpath of any Java project:

$ javac -classpath "oso-0.7.0.jar:." MyProject.java

$ java -classpath "oso-0.7.0.jar:." MyProject

For more information on the oso Java library, see the library documentation.

What’s next

After you’ve installed oso, check out the Quickstart.

Requirements

  • Java version 10 or greater

  • Supported platforms:

    • Linux

    • OS X

    • Windows

The Node.js version of oso is available on NPM and can be installed globally with NPM:

$ npm install -g oso@0.7.0

or added as a dependency to a project’s package.json manifest with NPM:

$ npm install oso@0.7.0

or Yarn:

$ yarn add oso@0.7.0

For more information on the oso Node.js library, see the library documentation.

What’s next

After you’ve installed oso, check out the Quickstart.

Requirements

  • Node.js version 10 or greater

  • Supported platforms:

    • Linux

    • OS X

    • Windows

The rust version of oso is available on crates.io.

Add oso and oso-derive as dependencies in your Cargo.toml

oso = "0.7.0"
oso-derive = "0.7.0"

For more information on the oso Rust library, see the library documentation.

What’s next

After you’ve installed oso, check out the Quickstart.

Requirements

  • Rust stable

  • Supported platforms:

    • Linux

    • OS X

    • Windows

Libraries coming soon:

  • JavaScript in the browser

  • Go

  • Rust

Source Code

The source code for oso is hosted on GitHub:

osohq/oso

Releases

See below for release notes: