Installation

Installation du package Python et du runtime BPM (bpm run). Pour l'app de démo (Next.js), voir Déployer.

Tout ce qui doit être installé

Selon ce que vous utilisez :

• Runtime Python (bpm run) : Python 3.9+, pip, puis pip install blueprint-modular.
• Application dashboard (Next.js, modules Wiki, IA, Documents, Gestion de parc, etc.) : Node.js, npm, PostgreSQL, Prisma (via npm install et npx prisma migrate deploy). Voir docs/DATABASE.md et Déployer.
• IA locale dans le runtime Python (bpm.ask, bpm.chat, etc.) : bpm setup installe Ollama et le modèle par défaut. Voir Modèles d’IA Workflow de démarrage.

Workflow de démarrage (recommandé)

Pour créer et lancer une app BPM avec IA locale en quelques commandes :

pip install blueprint-modular
bpm setup
bpm init --name mon-app
cd mon-app
bpm run app.py

bpm setup installe Ollama si besoin, démarre le service et télécharge le modèle par défaut (ex. llama3.2). Ensuite vous pouvez utiliser bpm.ask(), bpm.chat(), bpm.summarize() et bpm.analyze() dans votre app.py.

Modèles d’IA (Ollama)

Pour le module IA, l’analyse de documents et le sandbox « Par IA », l’application utilise par défaut Ollama en local. Il faut installer Ollama puis télécharger au moins un modèle.

1. Installer Ollama : ollama.com (Linux, macOS, Windows).
2. Lancer le service Ollama (souvent automatique après installation).
3. Télécharger un modèle recommandé (un seul suffit pour démarrer) :

   ollama pull qwen3:8b

   Autres modèles possibles : ollama pull qwen2.5:7b, ollama pull mistral:7b-instruct, ollama pull llama3.2:3b.
4. Configurer l’app : dans .env.local, définir AI_SERVER_URL=http://localhost:11434 (ou l’URL de votre serveur Ollama) et optionnellement AI_MODEL=qwen3:8b. En développement sans Ollama : AI_MOCK=true.

Détails et alternatives (Claude, OpenAI) : Module IA et documentation dans l’app (/modules/ia/documentation).

Prérequis (runtime Python)

• Python 3.9+
• pip à jour : pip install --upgrade pip
• Optionnel : environnement virtuel recommandé (python -m venv .venv)

Installation via pip

Le package est publié sur PyPI.

pip install blueprint-modular

Installation depuis les sources

Le dépôt est open source : github.com/Blueprint-Modular/blueprint-modular. Pour la plupart des usages, pip install blueprint-modular suffit. Pour contribuer ou développer le package : git clone https://github.com/Blueprint-Modular/blueprint-modular.git, puis cd blueprint-modular et pip install -e . (venv recommandé).

Lancer une app

bpm run app.py

L'app est servie sur http://localhost:8501 (port par défaut 8501, host et port configurables avec --port et --host).

Scaffolder une app vide

bpm init --name mon-app

Génère le dossier mon-app avec app.py, requirements.txt et README.md. Puis cd mon-app et bpm run app.py.

Vérifier l'installation

bpm --version