# How to Log in to Fimio and Create a Project

### 1. Log in to Fimio

* Go to the Fimio homepage at [`app.fimio.xyz`](https://app.fimio.xyz/).
* Log in using your GitHub account by entering your username or email address and password.

<figure><img src="https://862358326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCydCyt8Yq6B4XetUvsfH%2Fuploads%2FspCLEjYAAW4PAc0QIddU%2FScreenshot%202025-05-05%20at%202.24.31%E2%80%AFPM.png?alt=media&#x26;token=8ba4509f-c497-4dc5-b787-6492b3aeb78f" alt=""><figcaption></figcaption></figure>

### 2. Create a New Project

* Click on the option to create a project.

<figure><img src="https://862358326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCydCyt8Yq6B4XetUvsfH%2Fuploads%2FKhkySkH5nW2Iz2y8Ka5H%2Fimport%20repo.png?alt=media&#x26;token=3f0deec7-0f19-4983-8af0-df710908be76" alt=""><figcaption></figcaption></figure>



* If needed, select the owner of the repository you’d like to access.
  * Note: the default will be the user name you entered.
*

    <figure><img src="https://862358326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCydCyt8Yq6B4XetUvsfH%2Fuploads%2FjFVgyHdfJyl7H9jQfnZR%2FScreenshot%202025-05-05%20at%204.20.38%E2%80%AFPM.png?alt=media&#x26;token=9d83fc81-f740-4c77-bc72-e8455095a5ac" alt=""><figcaption></figcaption></figure>
* Select the repository with the code you want to run

<figure><img src="https://862358326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCydCyt8Yq6B4XetUvsfH%2Fuploads%2FrglJDuKvdDe9zyUrj892%2Fselct%20repo%20(smaller).png?alt=media&#x26;token=a282f236-dbb1-4e96-89d5-121868da41fb" alt=""><figcaption></figcaption></figure>

### 3. Add Project Details

<figure><img src="https://862358326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCydCyt8Yq6B4XetUvsfH%2Fuploads%2F2Kh4Vwok7TMPtf63xwyU%2Fcreate%20project.png?alt=media&#x26;token=675dd983-782a-44e0-adae-65e7f7e51845" alt=""><figcaption></figcaption></figure>

* Create a unique name for your project.
* Optionally, you may add a description for more context about the project.
* **For simple runs:**
  * select the entry point python file from the drop down menu.

<figure><img src="https://862358326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCydCyt8Yq6B4XetUvsfH%2Fuploads%2F9YuucEcwLHSXdtTQXWlh%2Fentry%20point%20file.png?alt=media&#x26;token=019a3aec-88a0-42fc-b67e-9ab7d044ae2e" alt=""><figcaption></figcaption></figure>

* Select “make build”.

### **4. Custom Command Options**

Commands may be customized by clicking the “Advanced” button. In advanced settings, users can:

* Enter specific codes
* Expose ports
* Add variables
* Include external files
* Toggle on GPU resources if needed

Once all custom commands have been entered, click “make build”.

<figure><img src="https://862358326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCydCyt8Yq6B4XetUvsfH%2Fuploads%2FoDRWeN2qGsowbJGMJZHy%2Fcreate%20proj%20advanced.png?alt=media&#x26;token=a43220d7-d3b3-4189-817c-a1c73831395a" alt=""><figcaption></figcaption></figure>

### **5. Name the Run**

Provide a name for the run itself. Think of these as similar to naming commits: when commits have meaningful names, they provide context that helps everyone understand why changes were made, not just what changes occurred. This makes the project history more valuable as a knowledge resource for the entire team.

<img src="https://862358326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCydCyt8Yq6B4XetUvsfH%2Fuploads%2FKQZ8tNtcMdaOWfLD6Av8%2Fname%20the%20run.png?alt=media&#x26;token=b680c137-ccdf-47b1-8767-fddbec6e9e13" alt="" data-size="original">\


Start Build.

### 6. Review Build Summary

After the build has finished, users can review information on the summary, run, and build itself by selecting the different tabs.\


<figure><img src="https://862358326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCydCyt8Yq6B4XetUvsfH%2Fuploads%2FZGNaroSvI5pgWX6Cg5wr%2FScreenshot%202025-05-05%20at%204.36.56%E2%80%AFPM.png?alt=media&#x26;token=ec61c60c-1e85-4831-926d-0d7c3f4b28d7" alt=""><figcaption></figcaption></figure>

From this page users may also rerun the exact same build, or move into the build report.

### **7. Access Build Report**

The preview build report shows the standard out and provides a link to share results with collaborators.\


<figure><img src="https://862358326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCydCyt8Yq6B4XetUvsfH%2Fuploads%2FLblEf4D4T1yopFNgBf6D%2Fbuild%20report%20(small).png?alt=media&#x26;token=d6ac98b0-837d-47ba-ad12-f7276fab1c9c" alt=""><figcaption></figcaption></figure>

"Continue to Build Details" will provide more in depth information about the run.

### **8. Review Project and Build Details**

The project details page provides all the information about the build and its configurations:

* the code that was run
* project details
* any code dependencies
* machine information
* standard error
* standard out
* sharable container (if the run produces one)

<figure><img src="https://862358326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCydCyt8Yq6B4XetUvsfH%2Fuploads%2FCG0gLF4kqwNmiY9ROmVM%2Fprojct%20details.png?alt=media&#x26;token=31c535fa-10dc-475c-bda1-37a9629d17ef" alt=""><figcaption></figcaption></figure>

### **9. Provide Feedback**

If users have any feedback or concerns, the [feedback repo](https://github.com/fimio-xyz/feedback) is accessible from every page. From there users can open an issue, submit a bug report, or start/review a discussion for troubleshooting.
