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.
On mobile, the dashboard starts with a compact submission count. Tap it to expand your results, success rate, last submission date, generation statistics, and access dates; tap again to hide the details. Wider screens show these details directly. A running-submissions link appears only while you have running submissions, and opens the page where you can manage them.
The Recent submissions list shows your latest five submissions (three on mobile). Open a name to see its details, choose View result when available, or use View all for the full list. Needs attention appears when you have failed submissions; expand it for links to the latest five failures and their errors. Use its X button to dismiss the notice. This account’s dismissal is remembered in the current browser; it returns when another submission fails, including a new execution of a previously dismissed submission. Removing or editing a dismissed failure does not bring the notice back. View all failed submissions opens your submissions page with the Failed filter selected. This filter retrieves only failed submissions; canceled runs have their own filter. Continue a draft appears only when you have saved drafts and opens the drafts manager.
Insights sits above Needs attention and Recent submissions. Expand it to see submission activity and the Best Solution Generation Quarter chart. Activity can cover the last 7 or 30 calendar days, including today, in your current time zone. It groups submissions by creation date and shows their current status: success, failed, pending, or canceled. This is not a history of execution attempts or status changes. Trashed submissions are excluded, and refreshing the page updates the data. View activity table exposes the exact daily counts for the selected period.
For help reading either chart, click the info icon beside its heading. The explanation opens in a modal so it stays out of the way while you browse. The generation-quarter chart becomes available when you have results; it does not compare fitness values across unrelated problems.
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 Select Template modal next to the field. It offers ready-made starting points you can adapt. See the Code templates section in Creating a Submission for details.
Optional: Prepare or Save First¶
On a new custom or Quick form, open the LEGA logo to get help preparing settings, or use Save draft to keep an incomplete form without starting a run. Custom code submissions can also attach private input files. These features do not change existing runs in place. See Prepare a New Submission with LEGA, Save and Manage Submission Drafts, and Custom Data Attachments.
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. Wait for confirmation that the submission was accepted and queued before closing the tab. You can then return later. Every event is persisted; nothing is lost when the browser disconnects.
If enabled in your preferences, 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.