Table of Contents

• Notebooks from Operação Serenata de Amor
  • What
  • How
    • To read
    • To download the datasets
    • To collaborate
  • Reminder

Notebooks from Operação Serenata de Amor

What

Operação Serenata de Amor has been acknowledged as a great AI project in Brazil and other countries. It has become not only a project to audit public expenses but also a space of sharing and collaboration. During its history, Serenata has had many people devoted to exploring its datasets through experimental notebooks which could possibly become a Rosie's classifier.

These notebooks from multiple authors are rich assets from which people can learn about data science, Python third-party libraries and core functions, as well as gather ideas for their own investigations.

Notebooks have been removed from the main repo, but with this exploratory and educative mindset, the team republishes the notebooks in this repo, also re-opening the space for collaboration and learning. Make yourself at home, you can read notebooks and share your own.

How

To read

• You can clone this repo by typing on your console:

$ git clone https://github.com/okfn-brasil/notebooks.git

• Alternatively you can download all the notebooks clicking the green "Clone or download" button on your right and choosing "Download ZIP".

• Alternatively you can launch in binder.

This provides a simple and disposable environment to run and visualize notebooks. Don't use that as your development environment and definitely don't add your credentials on this environment.

• Alternatively you can visualize the notebooks in read only mode using a public version of nbviewer

To download the datasets

We use serenata toolbox to download or generate the datasets. To install and use the toolbox just checkout the toolbox's guide.

To collaborate

Fork this repo and clone it. Then commit a new branch with your notebook and PR us. The files will be reviewed by @jtemporal and @rodolfo-viana.

If you are a newcomer or just confused about what to do, read getting-started.md.

Please remember to export a .py and .html to facilitate the review process. There's a sample config file at notebooks/jupyter_notebook_config.py to make Jupyter export these files automatically.

Reminder

The notebooks are available here for educational purposes. So please do not feel ashamed of commenting every step of your analysis, ok? Overusing documentation is better than no documentation at all.