Installation Guide¶
Machine Gnostics is distributed as a standard Python package. It is tested on macOS and Windows 11 with Python 3.11+ and is fully compatible with NumPy, pandas, SciPy, and other standard data science libraries.
1. Create a Python Virtual Environment¶
Best practice: use a virtual environment to avoid dependency conflicts.
2. Install Machine Gnostics¶
3. Verify Installation¶
4. Quick Usage Example¶
import numpy as np
from machinegnostics.magcal import EGDF
data = np.array([-13.5, 0, 1., 2., 3., 4., 5., 6., 7., 8., 9., 10.])
egdf = EGDF()
egdf.fit(data)
egdf.plot()
print(egdf.params)
5. Platform and Environment¶
- Operating System: macOS and Windows 11 (tested)
- Python Version: 3.11 or newer
- Dependencies: NumPy, pandas, SciPy compatible
- Alternative managers:
uv(recommended for speed);condaormambacan also manage the environment, then install withpip install machinegnosticsinside it
6. Troubleshooting¶
Always activate your virtual environment before installing or running:
- Upgrade pip:
pip install --upgrade pip - Check Python version:
python --version(must be 3.8+) - Clean install: Create a fresh environment and reinstall
- Network errors: Ensure a stable internet connection
- Permission errors: Do not use
sudo pip install; use a virtual environment instead
Find the full tutorial guide here.
Machine Gnostics is designed for simplicity and reliability, making robust machine learning accessible for all Python users.