Instalarea pachetului Python FERS

1. Instalați pachetul

Pachetul este publicat pe PyPI sub numele FERS. Conține stratul de modelare Python și wheel-ul solverului compilat, deci nu mai aveți nimic de construit.

pip install FERS

Necesită Python 3.11 sau mai nou. Se publică wheel-uri pentru Windows, macOS și Linux — instalarea nu cere un lanț de unelte Rust.

2. Verificați instalarea

Importați obiectele principale și construiți un model gol. Dacă rulează fără excepții, solverul compilat s-a încărcat corect.

from fers_core import FERS, Node, Member, Section, Material, NodalSupport, NodalLoad

# Quick smoke-test
model = FERS()
print("FERS installed successfully")

3. Autentificarea în cloud (opțional)

Aveți nevoie de aceasta doar pentru limitele Pro, pentru salvarea modelelor în cont și pentru punctele finale REST și MCP găzduite. Există două variante, în funcție de modul în care v-ați înregistrat.

1. Varianta A — cont cu e-mail și parolă — Schimbați credențialele pentru un token Bearer de o oră prin POST /api/sdk/token. Funcționează doar pentru conturile create cu e-mail și parolă.
2. Varianta B — cont Google sau GitHub (recomandată pentru toți) — Creați o cheie API permanentă din pagina de profil → API Keys. Fără parolă, funcționează pentru orice metodă de autentificare și poate fi revocată oricând.

Varianta A: token Bearer de scurtă durată

Tokenul este valabil o oră. La expirare cereți unul nou, în loc să îl stocați.

import requests

resp = requests.post("https://ferscloud.com/api/sdk/token", json={
    "email": "you@example.com",
    "password": "your_password",
})
token = resp.json()["token"]

Varianta B: cheie API permanentă

O cheie API are forma <keyId>.<secret> și este afișată o singură dată, la creare. Păstrați-o într-o variabilă de mediu și țineți-o pe server — niciodată în cod de browser sau într-un fișier versionat.

import os
os.environ["FERS_API_KEY"] = "<keyId>.<secret>"

Autentificarea în cloud este necesară doar pentru limitele Pro, pentru salvarea modelelor și pentru punctele finale găzduite. Calculul local cu run_analysis() funcționează fără nicio credențială.

Ce primiți fără să plătiți

Planul gratuit este destinat uzului necomercial: calculează modele de până la 100 bare, fără cont și fără cheie. Pro acoperă uzul comercial, ridică pragul la 10,000 bare și adaugă stocarea modelelor în cloud.

Nu există o cotă de calcule și nici un preț pe calcul, pe niciun canal: pachetul, comanda fers și serverul MCP local calculează pe calculatorul dumneavoastră, iar spațiul de lucru web calculează în browser. Pro costă 19.95 € pe lună.

Pașii următori

• Construiți și calculați un model — obiectele principale și un prim calcul.
• Exemple rezolvate — consolă, grindă simplu rezemată, cadru și o verificare conform EN 1993-1-1, fiecare cu calculul manual.
• De ce să automatizați un calcul — argumentele căii Python.