Documentation Technique & API

Nosia pour les développeurs - API OpenAI compatible

Découvrez comment intégrer Nosia dans vos applications avec une API 100% compatible OpenAI et comprendre son architecture technique ouverte. Solution auto-hébergée, open source et prête pour la production.

← Retour à la solution GitHub

API 100% Compatible OpenAI

Intégrez Nosia comme une alternative OpenAI auto-hébergée

L'API de Nosia est 100% compatible avec l'API Chat Completions d'OpenAI. Vos applications existantes fonctionnent sans modification. Remplacez simplement l'URL de base et utilisez votre propre modèle LLM.

Python

python

from openai import OpenAI

client = OpenAI(
    base_url="https://nosia.localhost/v1",
    api_key="votre-token"
)

response = client.chat.completions.create(
    model="default",
    messages=[{"role": "user", "content": "Que contiennent mes documents ?"}
],
    stream=True
)

for chunk in response:
    print(chunk.choices[0].delta.content or "", end="")

Node.js

javascript

import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://nosia.localhost/v1',
  apiKey: 'votre-token'
});

const response = await client.chat.completions.create({
  model: 'default',
  messages: [{ role: 'user', content: 'Résumez mes documents' }]
});

console.log(response.choices[0].message.content);

cURL

bash

curl https://nosia.localhost/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer votre-token" \
  -d '{
    "model": "default",
    "messages": [
      {"role": "user", "content": "Que contiennent mes documents ?"}
    ]
  }'

Déploiement simple et rapide

Déployez Nosia en quelques minutes sur votre infrastructure avec Docker. Solution prête pour la production avec monitoring intégré.

Installez Nosia en quelques minutes avec Docker Compose :

curl -fsSL https://get.nosia.ai | sh
docker compose up -d

Configuration minimale recommandée :

2 CPU, 4GB RAM (8GB recommandé pour production)
Docker & Docker Compose
Modèle LLM compatible OpenAI (Mistral, Granite, Llama, etc.)
PostgreSQL avec extension pgvector

Architecture technique ouverte

Client Web / API / Mobile

Caddy (Reverse Proxy / HTTPS / Load Balancing)

Rails Web (Puma) - API REST & Web Interface

Solid Queue Workers - Traitement asynchrone

PostgreSQL + pgvector (Vector Database)

• Embeddings vectoriels (1536 dimensions)

• Chat & Messages historique

• Chunks indexés avec recherche sémantique

• Metadata et tagging avancé

AI Services (External / Self-hosted)

• LLM (Mistral, Granite, Llama, etc.)

• Embedding Model (compatible OpenAI)

• OpenAI-compatible API endpoint

• Support multi-modèles et fallback

Documentation technique complète

Consultez la documentation officielle de Nosia pour plus de détails sur l'installation, la configuration avancée, l'API et les cas d'usage. Code source ouvert, exemples complets et support communautaire.

Voir la documentation GitHub