zulip/api_docs/configuring-python-bindings.md
Lauryn Menard 214008e92d api-docs: Move zuliprc file documentation to API keys article.
As zuliprc files are in a standard format that you can access from
any programming language, not just Python, it makes more sense to
have them documented with the information about API keys.

Fixes #10670.
2026-04-05 15:00:57 -07:00

1.3 KiB

Configuring the Python bindings

Zulip provides a set of tools that allows interacting with its API more easily, called the Python bindings. One of the most notable use cases for these bindings are bots developed using Zulip's bot framework.

In order to use them, you need to configure them with your identity (account, API key, and Zulip server URL). There are a few ways to achieve that:

  • Using a zuliprc file, referenced via the --config-file option or the config_file option to the zulip.Client constructor (recommended for bots).
  • Using a zuliprc file in your home directory at ~/.zuliprc (recommended for your own API key).
  • Using the environment variables documented here.
  • Using the --api-key, --email, and --site variables as command line parameters.
  • Using the api_key, email, and site parameters to the zulip.Client constructor.