Skip to content

Fix: Update requirements for simulations executions #6

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
OctavioNascimento wants to merge 2 commits into
base: main
Choose a base branch
from
Open

Fix: Update requirements for simulations executions #6

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
90dca98
Fix: Update requirements and README for Python 3.12 compatibility
Nov 8, 2025
fb3c3bb
Merge pull request #1 from OctavioNascimento/main
OctavioNascimento Nov 8, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
48 changes: 48 additions & 0 deletions INSTALLATION_README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
# CosmicBeats Simulator (Updated Installation Guide)

This repository is a fork of Microsoft's [CosmicBeats-Simulator](https://github.com/microsoft/CosmicBeats-Simulator). This README provides updated and validated installation instructions to ensure compatibility with modern development environments (like macOS or PCs with new Python versions).

The original simulation platform caters to diverse research interests, including networking, AI, computing, and more.

## ⚠️ Critical Prerequisites: Python 3.12

The project's dependencies have **critical incompatibilities** with the latest Python versions (e.g., Python 3.13+). Attempting to install with a newer Python version will result in compilation errors (specifically for `pydantic-core`, a sub-dependency).

To ensure a successful installation, you **must use Python 3.12**.

### Required Tools (macOS Example)
1. **Homebrew** (for macOS): Used to install Python. [Install Homebrew here](https://brew.sh/).
2. **Git:**
```bash
brew install git
```
3. **Python 3.12:**
```bash
brew install python@3.12
```
---

## 🚀 Installation Guide

Please follow these steps exactly to set up your environment.

### 1. Clone the Repository
Clone this repository to your local machine:
```bash
git clone [https://github.com/wocn-unicamp/CosmicBeats-Simulator.git](https://github.com/wocn-unicamp/CosmicBeats-Simulator.git)
cd CosmicBeats-Simulator

### 2. Fix the requirements.txt File
The original requirements.txt file pins old package versions that conflict with modern Python. We must first overwrite it to allow pip to install the latest compatible versions.
Replace the entire content of your requirements.txt file with the following:

astropy
dask
geopy
gradio
numpy
pandas
plotly
scipy
statsmodels
tqdm
18 changes: 10 additions & 8 deletions requirements.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,8 +1,10 @@
astropy==5.3.1
dask==2023.7.1
geopy==2.3.0
gradio==3.39.0
numpy==1.25.1
pandas==2.0.3
plotly==5.15.0
skyfield==1.46
astropy
dask
geopy
gradio
numpy
pandas
plotly
scipy
statsmodels
tqdm