Offizielle SDKs

npm install @palveron/sdk

pip install palveron-sdk

go get github.com/palveron/[email protected]

repositories { maven { url 'https://jitpack.io' } }
dependencies { implementation 'com.github.palveron:sdk-java:v1.0.0' }

import { Palveron } from '@palveron/sdk';

const palveron = new Palveron({
  apiKey: process.env.PALVERON_API_KEY!,
  // baseUrl: 'https://gateway.internal:8080', // On-Prem
});

const result = await palveron.verify({ prompt: userInput });

if (result.decision === 'BLOCKED') {
  throw new Error(result.reason);
}

// Quick-Check (Shorthand)
const { decision } = await palveron.check('Is this safe?');

// Mit File-Attachment
const fileResult = await palveron.verifyWithFile(
  'Analyze this document',
  './report.pdf'
);

from palveron import Palveron, VerifyRequest, Attachment

client = Palveron(api_key="pv_live_...")

# Text-Verifikation
result = client.verify("Check this prompt")
if result.is_blocked:
    raise RuntimeError(result.reason)

# Mit File-Attachment
result = client.verify_file("Analyze this", "/path/to/doc.pdf")

# Programmatisches Attachment
result = client.verify(VerifyRequest(
    prompt="Check this image",
    attachments=[Attachment.from_file("photo.jpg")],
))

from palveron import AsyncPalveron

async with AsyncPalveron(api_key="pv_live_...") as client:
    result = await client.verify("Check this")

import "github.com/palveron/sdk-go"

client := palveron.NewClient(os.Getenv("PALVERON_API_KEY"),
    // palveron.WithBaseURL("https://gateway.internal:8080"), // On-Prem
)

result, err := client.Verify(ctx, &palveron.VerifyRequest{
    Prompt: userInput,
})
if err != nil {
    log.Fatal(err)
}
if result.IsBlocked() {
    log.Fatal(result.Reason)
}

// Mit File
result, err = client.VerifyFile(ctx, "Analyze this", "/path/to/doc.pdf")

var client = Palveron.builder(System.getenv("PALVERON_API_KEY"))
    // .baseUrl("https://gateway.internal:8080") // On-Prem
    .build();

var result = client.verify("Check this prompt");
if (result.isBlocked()) {
    throw new SecurityException(result.reason());
}

// Mit File
var fileResult = client.verifyFile("Analyze this", Path.of("report.pdf"));

# LangChain-Beispiel
from palveron_langchain import PalveronCallbackHandler
from langchain_openai import ChatOpenAI

handler = PalveronCallbackHandler(api_key="pv_live_...")
llm = ChatOpenAI(model="gpt-4o", callbacks=[handler])

result = llm.invoke("Summarize the customer record for John Doe, [email protected]")
# → PalveronGovernanceError: Blocked — PII erkannt (E-Mail-Adresse)

# MCP-Server — zeigen Sie Ihren Coding-Agent auf diese URL
npx @palveron/mcp-server --api-key pv_live_...

# n8n — installieren über die Community-Nodes-UI von n8n

const result = await palveron.verify({
  prompt: agentOutput,
  context: {
    mcpServer: 'https://mcp.salesforce.com/sse',
    toolName: 'query_contacts',
    chainDepth: 2,
    sourceSystem: 'cursor-ide',
  },
});

const health = await palveron.health();
// { status: 'healthy', version: '1.0.0', uptime: 86400 }