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)

Este necesară doar pentru salvarea modelelor în cont, pentru canalul de agenți MCP și pentru limitele Pro. Există două metode, î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 salvarea modelelor și pentru funcțiile MCP și Pro. Calculul local cu run_analysis() funcționează fără nicio credențială.

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

Planul gratuit calculează modele de până la 100 bare, fără cont și fără cheie. Pro ridică pragul la 10,000 bare și adaugă stocarea modelelor în cloud.

Canalele de agenți și REST se contorizează separat: 100 calcule gratuite pe săptămână glisantă, apoi 0,01 € pe calcul din credit preplătit. 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.