# Getting Started with Repositories ## Getting Started with Repositories This beginner-friendly guide will help you get the basic skills you need to create and manage your repository on the Hub. Each section builds on the previous one, so feel free to choose where to start! ### Requirements This document shows how to handle repositories through the web interface as well as through the terminal. There are no requirements if working with the UI. If you want to work with the terminal, please follow these installation instructions. If you do not have `git` available as a CLI command yet, you will need to [install Git](https://git-scm.com/downloads) for your platform. You will also need to [install Git LFS](https://git-lfs.github.com/), which will be used to handle large files such as images and model weights. To be able to push your code to the Hub, you’ll need to authenticate somehow. The easiest way to do this is by installing the [`boincai_hub` CLI](https://huggingface.co/docs/huggingface_hub/index) and running the login command: Copied ``` python -m pip install boincai_hub boincai-cli login ``` **The content in the Getting Started section of this document is also available as a video!** ### Creating a repository Using the Hub’s web interface you can easily create repositories, add files (even large ones!), explore models, visualize diffs, and much more. There are three kinds of repositories on the Hub, and in this guide you’ll be creating a **model repository** for demonstration purposes. For information on creating and managing models, datasets, and Spaces, refer to their respective documentation. 1. To create a new repository, visit [boincai.com/new](http://huggingface.co/new): 2. Specify the owner of the repository: this can be either you or any of the organizations you’re affiliated with. 3. Enter your model’s name. This will also be the name of the repository. 4. Specify whether you want your model to be public or private. 5. Specify the license. You can leave the *License* field blank for now. To learn about licenses, visit the [**Licenses**](https://huggingface.co/docs/hub/repositories-licenses) documentation. After creating your model repository, you should see a page like this: Note that the Hub prompts you to create a *Model Card*, which you can learn about in the [**Model Cards documentation**](https://huggingface.co/docs/hub/model-cards). Including a Model Card in your model repo is best practice, but since we’re only making a test repo at the moment we can skip this. ### Adding files to a repository (Web UI) To add files to your repository via the web UI, start by selecting the **Files** tab, navigating to the desired directory, and then clicking **Add file**. You’ll be given the option to create a new file or upload a file directly from your computer. #### Creating a new file Choosing to create a new file will take you to the following editor screen, where you can choose a name for your file, add content, and save your file with a message that summarizes your changes. Instead of directly committing the new file to your repo’s `main` branch, you can select `Open as a pull request` to create a [Pull Request](https://huggingface.co/docs/hub/repositories-pull-requests-discussions). #### Uploading a file If you choose *Upload file* you’ll be able to choose a local file to upload, along with a message summarizing your changes to the repo. As with creating new files, you can select `Open as a pull request` to create a [Pull Request](https://huggingface.co/docs/hub/repositories-pull-requests-discussions) instead of adding your changes directly to the `main` branch of your repo. ### Adding files to a repository (terminal) #### Cloning repositories Downloading repositories to your local machine is called *cloning*. You can use the following commands to load your repo and navigate to it: Copied ``` git clone https://boincai.com// cd ``` You can clone over SSH with the following command: Copied ``` git clone git@hf.co:/ cd ``` You’ll need to add your SSH public key to [your user settings](https://huggingface.co/settings/keys) to push changes or access private repositories. #### Set up Now’s the time, you can add any files you want to the repository! 🔥 Do you have files larger than 10MB? Those files should be tracked with `git-lfs`, which you can initialize with: Copied ``` git lfs install ``` Note that if your files are larger than **5GB** you’ll also need to run: Copied ``` boincai-cli lfs-enable-largefiles . ``` When you use BOINC AI to create a repository, BOINC AI automatically provides a list of common file extensions for common Machine Learning large files in the `.gitattributes` file, which `git-lfs` uses to efficiently track changes to your large files. However, you might need to add new extensions if your file types are not already handled. You can do so with `git lfs track "*.your_extension"`. #### Pushing files You can use Git to save new files and any changes to already existing files as a bundle of changes called a *commit*, which can be thought of as a “revision” to your project. To create a commit, you have to `add` the files to let Git know that we’re planning on saving the changes and then `commit` those changes. In order to sync the new commit with the BOINC AI Hub, you then `push` the commit to the Hub. Copied ``` # Create any files you like! Then... git add . git commit -m "First model version" # You can choose any descriptive message git push ``` And you’re done! You can check your repository on BOINC AI with all the recently added files. For example, in the screenshot below the user added a number of files. Note that some files in this example have a size of `1.04 GB`, so the repo uses Git LFS to track it. ### Viewing a repo’s history Every time you go through the `add`-`commit`-`push` cycle, the repo will keep track of every change you’ve made to your files. The UI allows you to explore the model files and commits and to see the difference (also known as *diff*) introduced by each commit. To see the history, you can click on the **History: X commits** link. You can click on an individual commit to see what changes that commit introduced: --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://boinc-ai.gitbook.io/hub/getting-started-with-repositories.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.