update readme, small changes

Author: HenriqueAssumpcao

README.md

@@ -86,7 +86,7 @@ You can run codeevolve via the terminal as follows:
 ```bash
 codeevolve --inpt_dir=INPT_DIR --cfg_path=CFG_PATH --out_dir=RESULTS_DIR --load_ckpt=LOAD_CKPT --terminal_logging
 ```
-See `src/codeevolve/cli.py` for further details. Our [experiments repository](https://github.com/inter-co/science-codeevolve-experiments) multiple usage examples.
+The `scripts/run.sh` provides a bash script for running CodeEvolve using taskset in order to limit the CPU usage. See `src/codeevolve/cli.py` for further details. Our [experiments repository](https://github.com/inter-co/science-codeevolve-experiments) multiple usage examples.
 
 ### Customizing for Your Problem
 
@@ -97,7 +97,7 @@ CodeEvolve is designed for algorithmic problems with quantifiable metrics. To ap
 3. Configure evolutionary parameters (population size, mutation rates, etc.)
 4. Choose your LLM ensemble composition
 
-Comprehensive tutorials and example notebooks are coming soon.
+See `problems/problem_template` for a general template for running CodeEvolve on a python problem. Comprehensive tutorials and example notebooks are coming soon.
 
 ## Use Cases
 

problems/problem_template/configs/config_insp.yaml

@@ -0,0 +1,43 @@
+SYS_MSG: |
+  # PROMPT-BLOCK-START
+  TODO
+  # PROMPT-BLOCK-END
+      
+CODEBASE_PATH: 'src/'
+INIT_FILE_DATA: {filename: 'init_program.py', language: 'python'}
+EVAL_FILE_NAME: 'evaluate.py'
+EVAL_TIMEOUT: 60
+
+MAX_MEM_BYTES: 1000000000
+MEM_CHECK_INTERVAL_S: 0.1
+
+EVOLVE_CONFIG: {fitness_key: 'benchmark_ratio',
+                num_epochs: 100,ckpt: 10,max_size: null,init_pop: 10,
+                exploration_rate: 0.2, 
+                selection_policy: 'roulette', selection_kwargs: {roulette_by_rank: True},
+                early_stopping_rounds: null,
+                num_islands: 5, migration_topology: 'ring', migration_interval: 30, migration_rate: 0.1,
+                meta_prompting: True, use_embedding: False, use_map_elites: True,
+                num_inspirations: 3,
+                max_chat_depth: null,
+                mp_start_marker: "# PROMPT-BLOCK-START", mp_end_marker: "# PROMPT-BLOCK-END",
+                evolve_start_marker: "# EVOLVE-BLOCK-START", evolve_end_marker: "# EVOLVE-BLOCK-END",
+                use_scheduler: True, type: 'PlateauScheduler', scheduler_kwargs: {min_rate: 0.2, max_rate: 0.5, plateau_threshold: 5, increase_factor: 1.05, decrease_factor: 0.95}
+                }
+
+
+EXPLORATION_ENSEMBLE: [{model_name: 'GOOGLE_GEMINI-2.5-FLASH', temp: 0.9, top_p: 0.95, retries: 3, weight: 1, verify_ssl: False}]
+
+EXPLOITATION_ENSEMBLE: [{model_name: 'GOOGLE_GEMINI-2.5-FLASH', temp: 0.7, top_p: 0.95, retries: 3, weight: 0.60, verify_ssl: False},
+                        {model_name: 'GOOGLE_GEMINI-2.5-PRO', temp: 0.7, top_p: 0.95, retries: 3, weight: 0.40, verify_ssl: False}]
+
+SAMPLER_AUX_LM : {model_name: 'GOOGLE_GEMINI-2.5-FLASH', temp: 0.7, top_p: 0.95, retries: 3, weight: 1, verify_ssl: False}
+
+MAP_ELITES: {elite_map_type: 'grid',
+             features: [
+              {name: 'benchmark_ratio', min_val: 0, max_val: 1.2, num_bins: 100},
+              {name: 'eval_time', min_val: 0, max_val: 180, num_bins: 20},
+             ]
+}
+
+

problems/problem_template/configs/config_mp.yaml

@@ -0,0 +1,41 @@
+SYS_MSG: |
+  # PROMPT-BLOCK-START
+  TODO
+  # PROMPT-BLOCK-END
+      
+CODEBASE_PATH: 'src/'
+INIT_FILE_DATA: {filename: 'init_program.py', language: 'python'}
+EVAL_FILE_NAME: 'evaluate.py'
+EVAL_TIMEOUT: 60
+
+MAX_MEM_BYTES: 1000000000
+MEM_CHECK_INTERVAL_S: 0.1
+
+EVOLVE_CONFIG: {fitness_key: 'benchmark_ratio',
+                num_epochs: 500,ckpt: 10,max_size: null,init_pop: 15,
+                exploration_rate: 0.2, 
+                selection_policy: 'roulette', selection_kwargs: {roulette_by_rank: True},
+                early_stopping_rounds: null,
+                num_islands: 10, migration_topology: 'ring', migration_interval: 30, migration_rate: 0.1,
+                meta_prompting: True, use_embedding: False, use_map_elites: True,
+                num_inspirations: 3,
+                max_chat_depth: 5,
+                mp_start_marker: "# PROMPT-BLOCK-START", mp_end_marker: "# PROMPT-BLOCK-END",
+                evolve_start_marker: "# EVOLVE-BLOCK-START", evolve_end_marker: "# EVOLVE-BLOCK-END",
+                use_scheduler: True, type: 'PlateauScheduler', scheduler_kwargs: {min_rate: 0.2, max_rate: 0.5, plateau_threshold: 5, increase_factor: 1.05, decrease_factor: 0.95}
+                }
+
+EXPLORATION_ENSEMBLE: [{model_name: 'AWS_QWEN-QWEN3-CODER-30B-INSTRUCT', temp: 0.7, top_p: 0.8, retries: 3, weight: 1, verify_ssl: False}]
+
+EXPLOITATION_ENSEMBLE: [{model_name: 'AWS_QWEN-QWEN3-CODER-30B-INSTRUCT', temp: 0.7, top_p: 0.8, retries: 3, weight: 1, verify_ssl: False}]
+
+SAMPLER_AUX_LM : {model_name: 'AWS_QWEN-QWEN3-CODER-30B-INSTRUCT', temp: 0.7, top_p: 0.8, retries: 3, weight: 1, verify_ssl: False}
+
+EMBEDDING: {model_name: 'AZURE_TEXT-EMBEDDING-3-SMALL', retries: 3, verify_ssl: False, dimensions: 128}
+
+MAP_ELITES: {elite_map_type: 'grid',
+             features: [
+              {name: 'benchmark_ratio', min_val: 0, max_val: 1.2, num_bins: 100},
+              {name: 'eval_time', min_val: 0, max_val: 90, num_bins: 20},
+             ]
+}