Skip to main content

The Open Badges Client

Project description

OBC, the Open Badges Client

obc is a python library that provides a standard API to interact with Open Badge platforms.

Quick start guide

Install OBC

obc is distributed as a python package. It can be installed using pip (or any other package manager) from PyPI:

$ pip install obc

Use providers in your application

Let say you want to issue an existing Open Badge Factory badge for a list of recipients, an example implementation would look like:

from obc.providers.obf import BadgeIssue, BadgeQuery, OBF

# Configure Open Badge Factory provider using your client identifier and secret
# key
obf = OBF(client_id="my_obf_client_id", client_secret="super_secret")

# Get the badge with the "badge_id" identifier
badge = await anext("badge_id")))

# We want to issue a badge for the following recipients
issue = BadgeIssue(

issue = await obf.badges.issue(badge, issue)

More details will follow in the upcoming documentation.

Hack on the project

If you want to start contributing on the project, use the bootstrap Makefile target to build the Docker development image:

$ make bootstrap

To run tests, type:

$ make test

And to lint sources, there is also a command for that:

$ make lint

If you had new dependencies to the project, you will have to rebuild the Docker image (and the development environment):

$ make build && make dev

You can explore all other target using:

$ make help


This project is intended to be community-driven, so please, do not hesitate to get in touch if you have any question related to our implementation or design decisions.

We try to raise our code quality standards and expect contributors to follow the recommandations from our handbook.


This work is released under the MIT License (see LICENSE).

Project details

Download files

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

Source Distribution

obc-2.1.0.tar.gz (10.5 kB view hashes)

Uploaded Source

Built Distribution

obc-2.1.0-py2.py3-none-any.whl (9.6 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page