You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
description: Solutions for common problems encountered while using EvOC, such as browser cache errors and internet connectivity issues affecting microservices.
4
+
---
5
+
6
+
# Troubleshooting Common Issues
7
+
8
+
Encountering problems? Here are solutions for some common issues you might face while using EvOC.
9
+
10
+
## Issue 1: Error Immediately After Clicking "Get Started"
11
+
12
+
### Symptom
13
+
14
+
After accessing the EvOC web application and clicking the **`Get Started`** or **`Sign Up`** button on the homepage, you immediately see an error message, potentially similar to this:
15
+
16
+
17
+
18
+
### Cause
19
+
20
+
This often happens due to stale data stored in your web browser's cache from a previous visit or version of EvOC.
21
+
22
+
### Solution: Hard Refresh
23
+
24
+
The quickest solution is usually to perform a "hard refresh" of the page, which forces the browser to discard its cache and download the latest files from the server.
25
+
26
+
-**On most browsers (Windows/Linux):** Press `Ctrl` + `Shift` + `R`
27
+
-**On most browsers (Mac):** Press `Cmd` + `Shift` + `R` or `Cmd` + `Option` + `R`
28
+
29
+
Alternatively, you can try clearing your browser's cache specifically for the EvOC site through your browser's settings menu.
30
+
31
+
## Issue 2: Errors in Terminal Regarding Microservices (Local Install)
32
+
33
+
### Symptom
34
+
35
+
If you are running EvOC via a **local installation** (using Docker, etc.), you might see error messages appear in the terminal window where you launched the EvOC services. These errors often mention failures to connect to or fetch required microservices. The application UI might fail to load certain parts or become unresponsive. An example might look like this:
36
+
37
+
38
+
39
+
### Cause
40
+
41
+
This typically indicates that the different backend components (microservices) of your local EvOC installation cannot communicate properly, often due to network connectivity problems between your machine and the resources those services need (or sometimes between the services themselves if networking is misconfigured).
42
+
43
+
### Solution: Check Network & Restart
44
+
45
+
1.**Verify Internet Connectivity:** Ensure the machine running EvOC has a stable and active internet connection. Try accessing other websites.
46
+
2.**Check Network Configuration:** If using complex local network setups or VPNs, ensure they are not blocking communication required by EvOC's services.
47
+
3.**Restart EvOC Services:** Stop the running EvOC services in your terminal (usually with `Ctrl` + `C`). Wait a few seconds, and then restart them using the standard launch command (e.g., `docker compose up -d`).
48
+
4.**Retry:** Access the EvOC application interface again after restarting the services.
49
+
50
+
::: danger Persistent Issue?
51
+
If the problem continues after checking connectivity and restarting, consult the **[Local Installation Guide](./install/env-setup)** for more detailed setup verification steps or check for any specific network requirements mentioned there.
Copy file name to clipboardExpand all lines: index.md
+30-17Lines changed: 30 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,34 +3,47 @@ layout: home
3
3
4
4
hero:
5
5
name: "EvOC"
6
-
text: "User documentation"
7
-
tagline: "Documentation for the Evolutionary Algorithms On Click (EvOC) Project"
6
+
text: "Run & Visualize EAs with Just a Click"
7
+
tagline: A user-friendly framework (Evolve On Click) for designing, executing, and analyzing various evolutionary algorithms (EA, GP, PSO, ML Tuning) through an intuitive graphical interface. Perfect for learners, researchers, and educators – no coding required to get started!
8
8
image:
9
9
src: "/logo.png"
10
10
alt: "EvOC Logo"
11
11
actions:
12
12
- theme: brand
13
13
text: Get Started
14
-
link: /get-started
14
+
link: /introduction
15
15
- theme: alt
16
-
text: Explore
17
-
link: "/ea-run"
16
+
text: See Features in Action
17
+
link: /user-guide/ea-run
18
18
19
19
features:
20
-
- title: "Configure"
20
+
- title: "Intuitive Configuration"
21
21
icon: ⚙️
22
-
details: "Configure EA parameters for GP, PSO, DE, and traditional EA algorithms with ease."
23
-
link: "/ea-run"
24
-
- title: "Visualize"
22
+
details: "Visually configure parameters for Genetic Algorithms (GA), Genetic Programming (GP), Particle Swarm Optimization (PSO), and EA for ML Tuning via a simple GUI."
23
+
link: /user-guide/ea-run
24
+
25
+
- title: "Powerful Visualizations"
25
26
icon: 📈
26
-
details: "Visualize algorithm results through graphs and logs."
27
-
link: "/ea-run"
28
-
- title: "Generate Code"
27
+
details: "Instantly visualize algorithm progress with fitness plots, understand results with GP trees, or observe swarm behavior with PSO animations."
28
+
link: /user-guide/ea-run
29
+
30
+
- title: "Transparent Code Generation"
29
31
icon: 💻
30
-
details: "Generate Python code (powered by DEAP) for your configured algorithms."
31
-
link: "/ea-run"
32
-
- title: "Run, Save, & Share"
32
+
details: "Generate the underlying Python code (using the DEAP library) based on your GUI setup for transparency, learning, or further customization."
33
+
link: /user-guide/ea-run
34
+
35
+
- title: "EA for ML Tuning"
36
+
icon: 🧠
37
+
details: "Optimize Machine Learning model features or hyperparameters using Evolutionary Algorithms. Easily connect your data via Google Drive links."
38
+
link: /user-guide/ml-run
39
+
40
+
- title: "AI-Powered Explanations"
41
+
icon: ✨
42
+
details: "Don't understand the generated code or a specific EA concept? Ask the integrated EvOC AI for a clear explanation!"
43
+
link: /user-guide/ea-run
44
+
45
+
- title: "Execute, Save & Collaborate"
33
46
icon: 🚀
34
-
details: "Execute algorithms, save results, and share your findings effortlessly."
35
-
link: "/ea-run"
47
+
details: "Run experiments, track your execution history, download logs, and easily share your configurations and results with others."
Copy file name to clipboardExpand all lines: install/backend-setup.md
+6-1Lines changed: 6 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,3 +1,8 @@
1
+
---
2
+
title: Backend Setup
3
+
description: Deploy the EvOC backend services locally using Docker Compose. This guide provides step-by-step instructions for setting up the backend environment.
4
+
---
5
+
1
6
# Deploying EvOC Backend Locally
2
7
3
8
This guide will help you deploy the backend services of the Evolutionary Algorithms On Click (EvOC) project locally using Docker Compose.
Copy file name to clipboardExpand all lines: install/env-setup.md
+7Lines changed: 7 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,3 +1,8 @@
1
+
---
2
+
title: Installation Setup
3
+
description: Step-by-step guide to set up the environment for running EvOC locally, including Docker Desktop installation, GMail Mailer account setup, and optional VS Code installation.
4
+
---
5
+
1
6
# Setup Environment
2
7
3
8
## Docker Desktop
@@ -20,3 +25,5 @@
20
25
2. Install the **Docker extension** from Microsoft to manage services inside Docker using `.yml` files.
Copy file name to clipboardExpand all lines: install/frontend-setup.md
+7Lines changed: 7 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,3 +1,8 @@
1
+
---
2
+
title: Frontend Setup
3
+
description: Step-by-step guide to deploy the EvOC frontend locally using Next.js. This guide includes cloning the repository, installing dependencies, and running the application.
4
+
---
5
+
1
6
# Deploying EvOC Frontend Locally
2
7
3
8
The frontend is a Next.js application that communicates with the backend services. It is responsible for rendering the user interface and handling user interactions.
@@ -28,6 +33,8 @@ Create a `.env` file and paste the following configuration:
0 commit comments