Skip to main content

AI-powered architectural project execution CLI by Lovarch

Project description

lovarch-cli

CI License: MIT Python 3.11+ Release

AI-powered architectural project execution CLI — squad di 17 agenti specializzati che esegue audit input, briefing, normativa IT, CAD, BIM/IFC, computo metrico, capitolato, pratiche edilizie (CILA/SCIA), contratto CNAPPC, energy/LCA preliminare, dossier consolidato — in 14 minuti vs 3 settimane di lavoro tradizionale.

⚠️ Status: BETA (v0.1.x) — distribuito via Homebrew tap + pipx-from-git. Usato in produzione dagli iscritti al Corso IA Avanzato per Architetti (€1.497). Pubblicazione su PyPI valutata per v0.2+.

🌐 Lingue: 🇮🇹 Italiano (default) · 🇵🇹 Português · 🇬🇧 English · 🇪🇸 Español


Cosa fa

lovarch-cli orchestra il Squad Architettura-Progetto di Lovarch — 17 agenti AI con framework documentati (mind clones di Schumacher, Baldwin, Mazria, Deming, Juran, English, Dodds) — per generare 27 deliverable architettonici conformi alla normativa italiana:

  • Audit input (18 controlli) prima di iniziare
  • CAD quotato DXF/PDF (UNI ISO 5457, ±1mm)
  • BIM IFC4 LOD 300
  • Computo metrico (Prezzario Lombardia 2025)
  • Capitolato Speciale d'Appalto (UNI 11337-7 + CAM 2025)
  • Pratiche edilizie pre-compilate (CILA/SCIA/Paesaggistica)
  • Contratto CNAPPC + Equo Compenso L.49/2023
  • APE Preliminare + LCA Embodied Carbon
  • Dossier finale ZIP con 27 documenti

Due modalità

🆓 Free Mode (registrazione richiesta)

lovarch signup
# → Cadastro: Nome completo, email, telefono, paese, lingua
  • Esegui il squad localmente con i tuoi propri API keys (OpenAI, Mapbox, fal.ai)
  • Storage in ~/.lovarch/projects/ (filesystem locale)
  • Database in ~/.lovarch/local.db (SQLite)
  • Tutti i 17 agenti disponibili
  • Tu paghi le tue API direttamente ai provider

⭐ Premium Mode (login Lovarch)

arch login --premium
# → Apre il browser per autenticazione Lovarch (PKCE flow)
  • Login con il tuo account Lovarch esistente
  • Crediti inclusi nel piano (Personal €49 / Studio €99 / Business €199)
  • Backend Lovarch (Supabase + S3 + Edge Functions ottimizzate)
  • Sincronizzazione web app lovarch.com/admin/squad-execution/{id}/live
  • Team member ownership automatico

Installazione

🍺 Homebrew (raccomandato — macOS / Linux)

Il modo più semplice. Funziona anche per chi non ha familiarità con Python:

brew tap archprime-official/lovarch
brew install lovarch-cli
lovarch --version

brew upgrade lovarch-cli aggiorna alla nuova release.

📦 pipx — install isolato da GitHub

Se preferisci un'install Python isolata senza Homebrew (utile su Linux server, WSL, o se hai già pipx configurato):

# Ultima release (anche pre-release):
pipx install git+https://github.com/ArchPrime-official/lovarch-cli.git@v0.1.2

# Oppure dal branch main (rolling):
pipx install git+https://github.com/ArchPrime-official/lovarch-cli.git

pipx upgrade lovarch-cli aggiorna alla revisione successiva.

🛠️ Da sorgente (per sviluppatori / contributori)

git clone https://github.com/ArchPrime-official/lovarch-cli.git
cd lovarch-cli
python3.12 -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
pytest tests/      # → 142 passing
lovarch --version

Vedi CONTRIBUTING.md per il workflow di sviluppo.

Backward compatibility: il comando arch è alias di lovarch per chi ha già muscle memory dalla versione interna di sviluppo.

PyPI: la pubblicazione su pip install lovarch-cli è rimandata a v0.2+ (i metodi qui sopra coprono tutti i casi d'uso senza dipendere dalla burocrazia PyPI token/2FA).

Quick start

# Verifica installazione
lovarch --version    # → lovarch-cli 0.1.2

# Primo login (interattivo: Free o Premium)
lovarch login

# Inizializza un progetto (con --sample scarica villa-chianti da GitHub Releases)
lovarch init villa-toscana --sample

# Audit dei 18 input prima di girare il pipeline
lovarch audit villa-toscana

# Esegui workflow (Free=dry-run · Premium=produzione)
lovarch run dal-brief-al-cantiere villa-toscana

# Consolida deliverable in DOSSIER.zip
lovarch consolidate villa-toscana

# Stato di tutti i progetti
lovarch status

Comandi disponibili

Comando Descrizione
arch login Login Free o Premium
arch signup Cadastro Free interattivo
arch config Configurazione (API keys, lingua, storage path) — in arrivo (v0.2)
arch init <progetto> Crea nuovo progetto con struttura sample-input
arch audit <progetto> Esegue audit input (gate di ingresso)
arch run <workflow> Esegue workflow completo
arch consolidate <progetto> Genera DOSSIER.zip finale
arch status <id> Stato di una esecuzione
arch upgrade CTA per passare da Free a Premium
arch account delete Right-to-erasure GDPR

Vedi arch --help per dettagli completi.

Limiti dichiarati

lovarch-cli NON sostituisce:

  • ❌ Firma digitale qualificata (QES) dell'architetto abilitato
  • ❌ Calcolo strutturale NTC 2018 (richiede ingegnere strutturale)
  • ❌ Rilievo metrico in loco (richiede sopralluogo)
  • ❌ Coordinamento sicurezza CSP/CSE (D.Lgs 81/2008)
  • ❌ Responsabilità professionale del tecnico

L'utente assume la responsabilità di verifica e revisione professionale prima di qualsiasi presentazione ad autorità.

Licenza

MIT License — vedi LICENSE.

Link


🤖 Powered by Lovarch — AI Growth System for Architects & Designers

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

lovarch_cli-0.2.1.tar.gz (325.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

lovarch_cli-0.2.1-py3-none-any.whl (407.9 kB view details)

Uploaded Python 3

File details

Details for the file lovarch_cli-0.2.1.tar.gz.

File metadata

  • Download URL: lovarch_cli-0.2.1.tar.gz
  • Upload date:
  • Size: 325.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for lovarch_cli-0.2.1.tar.gz
Algorithm Hash digest
SHA256 2f5361736d3075ed274de4d7b88eb91d18148fada7b8ed665da1e8bf2073f36e
MD5 a19d97727efdbfe2c6325aa0f8af12d7
BLAKE2b-256 223a02062eeab48ce30790240b2582c86ac3189298279a7ec6e608491fd42bbc

See more details on using hashes here.

Provenance

The following attestation bundles were made for lovarch_cli-0.2.1.tar.gz:

Publisher: publish-pypi.yml on ArchPrime-official/lovarch-cli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file lovarch_cli-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: lovarch_cli-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 407.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for lovarch_cli-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 f05b411d5b2dd00f9d2c23d725fa25f722a61aa42ab2de79f4462bf62114ca3f
MD5 8454b5d4ae19af2887b5265afec8d500
BLAKE2b-256 06f1178ff808e641f3b72bcdbabab674fe2ede694a5b821b549df93ec6a5ea29

See more details on using hashes here.

Provenance

The following attestation bundles were made for lovarch_cli-0.2.1-py3-none-any.whl:

Publisher: publish-pypi.yml on ArchPrime-official/lovarch-cli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page