A Python package for integrating CARTO maps, analysis, and data services into data science workflows.

This component is still under support but it will not be further developed. We don’t recommend starting new projects with it as it will eventually become deprecated. Instead, learn more about our new Python packages here.


CARTOframes is an open-source library. We are more than happy to receive your contributions to the code and the documentation as well.

Filling a ticket

If you want to open a new issue in our repository, please follow these instructions:

  • Add a descriptive title.
  • Write a good description, answering the following questions:
    • What is happening?
    • What should happen instead?
    • How to reproduce the issue. Remember to include Browser, OS and CARTOframes version.
  • Try to add an example showing the problem.

Contributing code

The best part of open source: collaborate directly with our CARTOframes code! If you have fixed a bug or have a new functionality on your hands, we’d love to see it! These are the steps you should follow:

  • Sign our Contributor License Agreement (CLA) Learn more here
  • Fork the CARTOframes repository.
  • Create a new branch in your forked repository.
  • Commit your changes. Remeber to add new tests if possible.
  • Open a pull request.
  • Any of the CARTOframes mantainers will take a look.
  • If everything works, it will be merged and released \o/.
  • If you want more detailed information, this GitHub guide is a must.

Completing documentation

CARTOframes documentation is located in docs/. That folder is the content that appears in CARTO’s Developer Center. Follow the instructions described above and once we accept your pull request it will appear online :).

Submitting contributions

You will need to sign a Contributor License Agreement (CLA) before making a submission. Learn more here.