Skip to content

πŸš€ Install Colab

Captain FLAM edited this page Nov 13, 2023 · 10 revisions

Your CONFIGURATION will be saved each time you click the Β« Start Β» button.

I've developed this project with GUI in mind and it works on Colab :

🎯 How to install ?

There is a quick video tutorial on YouTube :

How to install on Colab - made by Β© Bas Curtiz


βœ… Installation

1️⃣ Go there : Open In Colab

and copy this Colab notebook on your Google Drive.
(Menu > File > Save a copy on Drive)

2️⃣ Run your Colab Notebook and authorize the access to your Google Drive ... That's it ! 😎

3️⃣ If you want to save your credit units, activate the [ This is the end... ] option and KaraFan will kill the Colab session at the end of the process .

βœ… How To Update ?

1️⃣ Only IF you have any trouble, start from a NEW Colab Notebook :

  • Delete your actual copy of the KaraFan notebook
  • Start fom a fresh one : Open In Colab

2️⃣ Else just Restart your Colab :

  • Choose the first option available between these 2 in the menu "Runtime"

Restart Colab

3️⃣ Run your Colab AGAIN ... That's it ! 😎

β›” Troubleshooting

Note

If you manually disconnect while saving an audio file, you will need to delete this file before restarting Colab, as the saved file may be incomplete !!
And especially if the "GOD Mode" is activated !

~
from the BIG Google Doc made by Β© Deton 24 :

Important

Contrary to every other Colab in this document, KaraFan uses a GUI which launches after executing cells. It triggers Google’s timeout security checks frequently esp. in free Colab users, because Google behaves like the separation is not being executed where you do it in GUI, and it’s generally against their policies to execute such code instead pasting commands to execute in Colab cells directly. The same way many RVC Colabs got blocked by Google, but this one is generally not directly for voice cloning, and is not very popular yet, so it wasn’t targeted by Google yet.

Warning

Once you start separation, it can get you disconnected from runtime quickly, especially if you miss some multiple captcha prompts (although for 19.10.23 they stopped appearing so frequently).

Warning

If you see an error that you're disconnected from KaraFan Colab, it can still separate files in the background and it happens even if you close the Colab. So, you can see your GDrive output folder still constantly populated with new files, while progress bar is not being refreshed after error of runtime disconnection or even after Closing your tab with Colab. At certain point it can interrupt the process, leaving you with not all output files. Be aware that final files always have β€œFinal” in their names.

Warning

Also, it can consume free "credits" till you click "Environment > Terminate session". It happens even if you close the Colab tab.

Warning

As for 4.2 version, session crashes for free Colab users can occur, due to running out of memory. You can try out shorter files. Maybe too, lower chunks (below 500k for too long tracks if something hasn't changed in the code). Also, check with some other input file you used before and worked before first.

Important

Currently, if you rename your output folder with separation, and retry separation, it will look for the old folder with separation to delete, and return the error, and running the GUI cell again may cause disappearing of GUI elements. it's a default behavior of Colab and IPython core : Sync of files the Colab sees is not real time Two possible solutions:

  • wait until sync with Google Drive is done
  • restart & run Colab

Important

Sometimes shutting down your environment in Environment options and starting over might do the trick if something doesn't work. E.g. (if it wasn't fixed), when you manipulate input files on GDrive when GUI is still opened and you just finished separation, you might run into an error when you start separating another file with input folder content changed. In order to avoid it, you need to run the GUI cell again after you've changed the input folder content (IRC it's "Music" folder by default).

πŸ“‚ STRUCTURE

After installation, you'll find new folders at the root of your Google Drive with the following structure :

Folder Function
/ KaraFan-master If you are a Developer and set the option to True in the notebook
/ KaraFan_user where config files are saved
/ KaraFan_user / Models Where all the models are stored
/ KaraFan_user / Multi_Song If you want to test SDR with your own recipes
/ Music Here you can put your audio files (or choose another one)
/ Results Here you will find your extracted audio files (or another one)

~