Python client library for CircleCI API.

circleclient is a Python client library used for accessing CircleCI API to retrieve information about builds. It can also be used to start and stop builds. Full list of implemented features can be found in the usage section.

Main Features

  • Start build
  • Cancel build
  • Retry build
  • Run parametrized builds
  • Retrieve information about user
  • Retrieve information about build(s)
  • List followed repositories
  • List build artifacts
  • Clear build cache


If you have any suggestions or questions about circleclient feel free to email me at

If you encounter any errors or problems with circleclient, please let me know! Open an Issue at the GitHub main repository.