Skip to content

Commit 39c4281

Browse files
Y0CossY0Coss
authored
Merge pull request #8080 from ovh/FB-install-IA-agent-VPS
FB - Install IA agent on VPS
2 parents f787b94 + 86ab574 commit 39c4281

File tree

6 files changed

+295
-0
lines changed

6 files changed

+295
-0
lines changed

‎pages/bare_metal_cloud/virtual_private_servers/install-ia-agent-on-vps/guide.en-gb.md

Lines changed: 146 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,146 @@
1+
---
2+
title: 'How to install an AI agent on an OVHcloud VPS'
3+
excerpt: 'Find out how to deploy an AI agent like Open Interpreter or GPT4All on an OVHcloud VPS'
4+
updated: 2025-08-18
5+
---
6+
7+
## Objective
8+
9+
This guide explains how to deploy an on-premises AI agent on an OVHcloud VPS, without depending on the cloud of external providers. You will use a ready-to-use Docker container containing an open-source AI agent, such as [Open Interpreter](https://github.com/openinterpreter/open-interpreter), [GPT4All](https://github.com/nomic-ai/gpt4all) or [Auto-GPT](https://github.com/Significant-Gravitas/AutoGPT).
10+
11+
**Find out how to deploy an AI agent such as Open Interpreter or GPT4All on an OVHcloud VPS.**
12+
13+
## Requirements
14+
15+
- An [OVHcloud VPS](/links/bare-metal/vps) (Debian 11 or higher is recommended)
16+
- Administrative (sudo) SSH access to your server
17+
- Python ≥ 3.10 installed on the VPS
18+
19+
## Instructions
20+
21+
### Update your VPS and install Python <a name="step1"></a>
22+
23+
Open a terminal and connect to your VPS with the following command (replacing `VPS_IP` with the real IP):
24+
25+
```bash
26+
ssh <user>@VPS_IP
27+
```
28+
29+
Update the packages:
30+
31+
```bash
32+
sudo apt update && sudo apt upgrade -y
33+
```
34+
35+
Verify that Python ≥ 3.10 is installed:
36+
37+
```bash
38+
python3 --version
39+
```
40+
41+
If necessary, install Python 3.10+ and pip:
42+
43+
```bash
44+
sudo apt install -y python3 python3-pip python3-venv
45+
```
46+
47+
### Create a virtual environment and install Open Interpreter <a name="step2"></a>
48+
49+
Recent environments limit the use of `pip` globally. It is recommended that you create and use a virtual environment:
50+
51+
```bash
52+
python3 -m venv ~/venv-openinterpreter
53+
source ~/venv-openinterpreter/bin/activate
54+
```
55+
56+
Install Open Interpreter:
57+
58+
```bash
59+
pip install --upgrade pip
60+
pip install open-interpreter
61+
```
62+
63+
### Configure an AI template for the agent (local or remote) <a name="step3"></a>
64+
65+
#### Option 1 - Use OpenAI (GPT-4o, GPT-3.5, etc.)
66+
67+
You must have an OpenAI API key. Add it when you launch it for the first time, or set it beforehand:
68+
69+
```bash
70+
export OPENAI_API_KEY="API_KEY"
71+
interpret
72+
```
73+
74+
Then follow the instructions.
75+
76+
#### Option 2 - Use a local model (via Ollama)
77+
78+
If you do not want to use OpenAI, run a local model using Ollama:
79+
80+
```bash
81+
interpreter --local
82+
```
83+
84+
This will give you several options (Ollama, LM Studio, etc.). We recommend using Ollama, as it is easy to install and compatible with several modern models such as `llama3` or `mistral`.
85+
86+
Install Ollama:
87+
88+
```bash
89+
sudo apt install curl -y
90+
curl -fsSL https://ollama.com/install.sh | sh
91+
exec $SHELL
92+
```
93+
94+
Load the model:
95+
96+
```bash
97+
ollama pull mistral
98+
```
99+
100+
Then try again:
101+
102+
```bash
103+
interpreter --local
104+
```
105+
106+
#### Common errors
107+
108+
**Model requires more system memory (6 GiB) than is available (1 GiB)**
109+
110+
This error indicates that your VPS does not have enough RAM. Here are your options:
111+
112+
- Choose a new VPS with at least 8 GB RAM.
113+
- Use the OpenAI API (see `Option 1` above).
114+
- Use a lighter model, like mistral.
115+
116+
### Test your AI Agent <a name="step4"></a>
117+
118+
Test the following use cases:
119+
120+
```console
121+
What is in the /tmp folder?
122+
```
123+
124+
Sample response:
125+
126+
![AI agent](images/question-version-python.png){.thumbnail}
127+
128+
```console
129+
Write a Python script that lists the files in the current folder.
130+
```
131+
132+
The agent interprets your request, generates code, and executes it locally.
133+
134+
Sample response:
135+
136+
![AI agent](images/question-python-script.png){.thumbnail}
137+
138+
### Conclusion <a name="step5"></a>
139+
140+
With this guide, you have installed an AI agent on your OVHcloud VPS, capable of executing commands from simple natural language instructions. Whether you have opted for a remote model like GPT-4 via OpenAI or a local model like Mistral via Ollama, you now have an intelligent assistant directly in your terminal, without dependency on a web interface or a third-party service.
141+
142+
## Go further
143+
144+
For specialized services (SEO, development, etc.), contact [OVHcloud partners](/links/partner)
145+
146+
Join our [community of users](/links/community).

‎pages/bare_metal_cloud/virtual_private_servers/install-ia-agent-on-vps/guide.fr-fr.md

Lines changed: 146 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,146 @@
1+
---
2+
title: 'Comment installer un agent IA sur un VPS OVHcloud'
3+
excerpt: 'Découvrez comment déployer un agent IA comme Open Interpreter ou GPT4All sur un VPS OVHcloud'
4+
updated: 2025-08-18
5+
---
6+
7+
## Objectif
8+
9+
Ce guide explique comment déployer un agent IA local sur un VPS OVHcloud, sans dépendre du cloud de fournisseurs externes. Vous utiliserez pour cela un conteneur Docker prêt à l'emploi contenant un agent IA open source comme [Open Interpreter](https://github.com/openinterpreter/open-interpreter), [GPT4All](https://github.com/nomic-ai/gpt4all) ou [Auto-GPT](https://github.com/Significant-Gravitas/AutoGPT).
10+
11+
**Découvrez comment déployer un agent IA comme Open Interpreter ou GPT4All sur un VPS OVHcloud.**
12+
13+
## Prérequis
14+
15+
- Disposer d'un [VPS](/links/bare-metal/vps) fonctionnel (Debian 11 ou supérieur recommandé)
16+
- Disposer d'un accès administrateur (sudo) via SSH à votre serveur
17+
- Python ≥ 3.10 installé sur le VPS
18+
19+
## En pratique
20+
21+
### Mettre à jour votre VPS et installer Python <a name="step1"></a>
22+
23+
Ouvrez un terminal et connectez-vous à votre VPS avec la commande suivante (en remplaçant `IP_VPS` par la véritable IP) :
24+
25+
```bash
26+
ssh <user>@IP_VPS
27+
```
28+
29+
Mettez à jour les paquets :
30+
31+
```bash
32+
sudo apt update && sudo apt upgrade -y
33+
```
34+
35+
Vérifiez que Python ≥ 3.10 est installé :
36+
37+
```bash
38+
python3 --version
39+
```
40+
41+
Si nécessaire, installez Python 3.10+ et pip :
42+
43+
```bash
44+
sudo apt install -y python3 python3-pip python3-venv
45+
```
46+
47+
### Créer un environnement virtuel et installer Open Interpreter <a name="step2"></a>
48+
49+
Les environnements récents limitent l’usage de `pip` globalement. Il est recommandé de créer et d'utiliser un environnement virtuel :
50+
51+
```bash
52+
python3 -m venv ~/venv-openinterpreter
53+
source ~/venv-openinterpreter/bin/activate
54+
```
55+
56+
Installez Open Interpreter :
57+
58+
```bash
59+
pip install --upgrade pip
60+
pip install open-interpreter
61+
```
62+
63+
### Configurer un modèle IA pour l’agent (local ou distant) <a name="step3"></a>
64+
65+
#### Option 1 – Utiliser OpenAI (GPT-4o, GPT-3.5, etc.)
66+
67+
Vous devez disposer d’une clé API OpenAI. Ajoutez-la lors du premier lancement ou en la définissant au préalable :
68+
69+
```bash
70+
export OPENAI_API_KEY="API_KEY"
71+
interpreter
72+
```
73+
74+
Suivez ensuite les instructions.
75+
76+
#### Option 2 – Utiliser un modèle local (via Ollama)
77+
78+
Si vous ne souhaitez pas utiliser OpenAI, exécutez un modèle local grâce à Ollama :
79+
80+
```bash
81+
interpreter --local
82+
```
83+
84+
Cela vous proposera plusieurs options (Ollama, LM Studio, etc.). Nous vous recommandons d'utiliser Ollama, car il est facile à installer et compatible avec plusieurs modèles modernes comme `llama3` ou `mistral`.
85+
86+
Installez Ollama :
87+
88+
```bash
89+
sudo apt install curl -y
90+
curl -fsSL https://ollama.com/install.sh | sh
91+
exec $SHELL
92+
```
93+
94+
Chargez le modèle :
95+
96+
```bash
97+
ollama pull mistral
98+
```
99+
100+
Puis relancez :
101+
102+
```bash
103+
interpreter --local
104+
```
105+
106+
#### Erreurs fréquentes
107+
108+
**Model requires more system memory (6 GiB) than is available (1 GiB)**
109+
110+
Cette erreur indique que votre VPS n’a pas assez de mémoire vive (RAM). Voici vos options :
111+
112+
- Opter pour un VPS disposant d'au moins 8 Go de RAM.
113+
- Utiliser l'API OpenAI (voir `Option 1` ci-dessus).
114+
- Utiliser un modèle plus léger, comme Mistral.
115+
116+
### Tester votre agent IA <a name="step4"></a>
117+
118+
Testez les exemples d'utilisation suivants :
119+
120+
```console
121+
Quel est le contenu du dossier /tmp ?
122+
```
123+
124+
Exemple de réponse :
125+
126+
![IA agent](images/question-version-python.png){.thumbnail}
127+
128+
```console
129+
Écris un script Python qui liste les fichiers dans le dossier courant.
130+
```
131+
132+
L’agent interprète votre demande, génère du code et l’exécute localement.
133+
134+
Exemple de réponse :
135+
136+
![IA agent](images/question-python-script.png){.thumbnail}
137+
138+
### Conclusion <a name="step5"></a>
139+
140+
Grâce à ce guide, vous avez installé un agent IA sur votre VPS OVHcloud, capable d’exécuter des commandes à partir de simples instructions en langage naturel. Que vous ayez opté pour un modèle distant comme GPT-4 via OpenAI ou un modèle local comme Mistral via Ollama, vous disposez désormais d’un assistant intelligent directement dans votre terminal, sans dépendance à une interface web ou à un service tiers.
141+
142+
## Aller plus loin
143+
144+
Pour des prestations spécialisées (référencement, développement, etc), contactez les [partenaires OVHcloud](/links/partner)
145+
146+
Échangez avec notre [communauté d'utilisateurs](/links/community).

‎pages/bare_metal_cloud/virtual_private_servers/install-ia-agent-on-vps/images/question-python-script.png

235 KB
Loading

‎pages/bare_metal_cloud/virtual_private_servers/install-ia-agent-on-vps/images/question-version-python.png

100 KB
Loading

‎pages/bare_metal_cloud/virtual_private_servers/install-ia-agent-on-vps/meta.yaml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
id: 81b4dda2-5ca2-4868-b6a0-232ec0af92d5
2+
full_slug: vps-install-ia-agent

‎pages/index.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -300,6 +300,7 @@
300300
+ [Automating the deployment of your website on your VPS via GitHub Actions](bare_metal_cloud/virtual_private_servers/deploy-website-github-actions)
301301
+ [Automating the deployment of your website on your VPS via GitLab CI/CD](bare_metal_cloud/virtual_private_servers/deploy-website-gitlab-ci-cd)
302302
+ [How to create and import a Lovable website on an OVHcloud VPS](bare_metal_cloud/virtual_private_servers/import-lovable-website-on-vps)
303+
+ [How to install an AI agent on an OVHcloud VPS](bare_metal_cloud/virtual_private_servers/install-ia-agent-on-vps)
303304
+ [Managed Bare Metal](products/bare-metal-cloud-managed-bare-metal)
304305
+ [OVHcloud services and options](bare-metal-cloud-managed-bare-metal-ovhcloud-services-and-options)
305306
+ [Setting up a VPN for OVHcloud Zerto DRP](bare_metal_cloud/managed_bare_metal/zerto-virtual-replication-customer-to-ovhcloud)

0 commit comments

Comments
 (0)