auto-notebook-creator / CONTRIBUTING.md
asoria's picture
asoria HF staff
Adding contribute tutorial
fb1a11c

How to contribute

Thanks for your interest in contributing! ๐Ÿ™Œ This project helps users quickly create notebooks to showcase how they use datasets. The generated code can be added to their repositories or used in research projects.

Ways to Contribute

There are a few ways you can help:

  • ๐Ÿ’กShare ideas: Got a cool feature in mind? Let us know!
  • ๐ŸžReport bugs: If something isnโ€™t working, weโ€™d love to fix it.
  • ๐Ÿš€Suggest improvements: Any suggestions to make the tool better are welcome.
  • ๐Ÿ““Add new notebook types: This is one of the most exciting ways to contribute!

For Ideas, Bugs, or Suggestions:

  • Start a new discussion here.
  • Tell me whatโ€™s on your mind and include any details that might help.

For Adding New Notebook Types:

  • Open a pull request (PR) here.
  • Add a new .json file in the notebooks folder. Thereโ€™s a sample file you can copy and tweak.
  • Submit your PR! ๐ŸŽ‰

Running the Space Application

To execute the space, follow these steps:

  1. Set Required Environment Variables:
  • NOTEBOOKS_REPOSITORY: The name of the repository where the generated notebooks will be stored. Ensure that you have write permissions for this repository. For example, I use asoria/dataset-notebook-creator-content repository.
  • HF_TOKEN: Your Hugging Face token, used for authentication to push changes to the repository.

Example setup:

export HF_TOKEN=your_huggingface_token
export NOTEBOOKS_REPOSITORY=your_repository_name
  1. Execute the following command to start the application:
python app.py

I am excited to see what you come up with. Thanks for helping make this project even better! ๐Ÿ’–