Your first submission
Sign up, fill in a quick form, and read the result.
This page walks you through one full run from start to finish. It uses one of the quick forms. You do not need to write any code.
1. Create an account¶
Open the home page and click Sign in. Pick one of the three sign-up options (Google, GitHub, or email and password) and confirm your email when the verification message arrives. The account is free and you start with a small amount of credits so you can run a few jobs without paying. For more on the sign-in flow, see Signing up and signing in.
2. Pick a quick form¶
From the app dashboard, click Quick start. The same option exists in the side navigation bar.
Each card is a common problem with the parameters set to sensible defaults:
- Binary subset sum
- Single-objective optimisation
- Multi-objective optimisation
- Travelling salesman
- 2D clustering
- Sklearn random forest hyperparameters
- Keras / PyTorch neural network training
Pick the one closest to what you want. If none of them fit, use the full "new submission" form instead. See Creating a submission for the difference.
3. Fill in the parameters¶
Each field has an i icon next to it. Click it to read what the field does and what range of values is sensible. The defaults are usually a good starting point. If you are unsure, leave them.
For a full reference of every parameter the form accepts, see Submission parameters.
If you are on the full new-submission form (rather than a quick card) and need help writing the fitness function or a callback, open the Use a template modal next to the field. It offers ready-made starting points you can adapt. See the Use a template section in Creating a submission for details.
4. Submit and watch it run¶
Press the submit button. Vilvik validates the parameters, queues the run, and sends you to a live progress page that updates in real time. The fitness chart grows, the generation counter ticks up, and when the run finishes the page switches to the final result view.
Streaming is a convenience, not a requirement. You can close the tab the moment you press submit and come back later. Every event is persisted; nothing is lost when the browser disconnects.
You will also get an email when the run finishes. You can opt in or out of run-completion emails from your profile settings.
5. Read the result¶
The result page shows details including:
- The best solution found, with its fitness value.
- A fitness chart over generations, and a problem-specific chart when applicable.
- Download buttons for the best solution and, when produced, the run log.
- A Continue button that lets you start a new run from where this one stopped.
- An Edit and re-execute button to tweak parameters and run a child submission.
- A Re-execute button to run the same parameters again from scratch.
- A Share menu for making the result public, listing it in the gallery, or inviting specific people.
- A Delete button for removing the result.
The full reference is at Reading a result.
That is one complete run. From here you can read about your submissions list, continuing a submission, or move on to the REST API.