Getting Started

# Check if server is running
curl http://localhost:50051

# Or use grpcurl
grpcurl -plaintext localhost:50051 list

# Expected output:
# grpc.health.v1.Health
# bias.BiasService

# Create systemd service file
sudo tee /etc/systemd/system/biasd.service <<EOF
[Unit]
Description=BIAS gRPC Server
After=network.target

[Service]
Type=simple
User=bias
WorkingDirectory=/opt/bias
ExecStart=/opt/bias/target/release/biasd
Restart=always

[Install]
WantedBy=multi-user.target
EOF

# Start service
sudo systemctl daemon-reload
sudo systemctl enable biasd
sudo systemctl start biasd

# Check status
sudo systemctl status biasd

# Clone bindings repository
git clone https://gitlab.com/agentforgelabs-group/BIAS-Bindings.git
cd BIAS-Bindings/python

# Install dependencies
pip install grpcio grpcio-tools

# Install BIAS client
pip install -e .

# Verify installation
python -c "from bias_bindings import bias_pb2; print('BIAS Python bindings installed!')"

# Clone bindings repository
git clone https://gitlab.com/agentforgelabs-group/BIAS-Bindings.git
cd BIAS-Bindings/typescript

# Install dependencies
npm install

# Build TypeScript
npm run build

# Link for local development
npm link

# Use in your project
cd /your/project
npm link @bias/client

# test_bias.py
import grpc
from bias_bindings import bias_pb2, bias_pb2_grpc
import json

# Connect to BIAS server
channel = grpc.insecure_channel('localhost:50051')
stub = bias_pb2_grpc.BiasServiceStub(channel)

# Test encoding
data = {"test": "Hello BIAS!", "value": 123}
request = bias_pb2.EncodeRequest(
    json_input=json.dumps(data),
    format="inline"
)
response = stub.Encode(request)

print("Original:", json.dumps(data))
print("Encoded:", response.bias_output)
print("✓ BIAS is working!")

import grpc
from bias_bindings import bias_pb2, bias_pb2_grpc
import json
import openai

# Setup BIAS client
channel = grpc.insecure_channel('localhost:50051')
bias = bias_pb2_grpc.BiasServiceStub(channel)

# Your data
context = {
    "user": {"id": 123, "name": "Alice"},
    "items": [
        {"id": 1, "name": "Widget", "price": 9.99},
        {"id": 2, "name": "Gadget", "price": 19.99}
    ]
}

# Encode with BIAS
request = bias_pb2.EncodeRequest(
    json_input=json.dumps(context),
    format="inline"
)
encoded = bias.Encode(request).bias_output

print(f"Original tokens: ~{len(json.dumps(context).split())}")
print(f"BIAS tokens: ~{len(encoded.split())}")
print(f"Savings: ~{(1 - len(encoded)/len(json.dumps(context)))*100:.0f}%")

# Use with OpenAI
response = openai.ChatCompletion.create(
    model="gpt-4",
    messages=[{
        "role": "user",
        "content": f"Analyze this data (BIAS format):\n{encoded}"
    }]
)

print(response.choices[0].message.content)

import { BiasClient } from '@bias/client';
import Anthropic from '@anthropic-ai/sdk';

const bias = new BiasClient({ endpoint: 'localhost:50051' });
const anthropic = new Anthropic({ apiKey: process.env.ANTHROPIC_API_KEY });

async function main() {
  // Your data
  const context = {
    user: { id: 123, name: 'Alice' },
    items: [
      { id: 1, name: 'Widget', price: 9.99 },
      { id: 2, name: 'Gadget', price: 19.99 }
    ]
  };

  // Encode with BIAS
  const encoded = await bias.encode(context, { format: 'inline' });

  console.log('Original:', JSON.stringify(context).length, 'bytes');
  console.log('BIAS:', encoded.length, 'bytes');
  console.log('Savings:', ((1 - encoded.length / JSON.stringify(context).length) * 100).toFixed(0) + '%');

  // Use with Claude
  const message = await anthropic.messages.create({
    model: 'claude-3-opus-20240229',
    max_tokens: 1024,
    messages: [{
      role: 'user',
      content: `Analyze this data (BIAS format):\n${encoded}`
    }]
  });

  console.log(message.content[0].text);
}

main();

[server]
host = "0.0.0.0"
port = 50051
workers = 4

[limits]
max_depth = 128
max_entities = 100000
max_payload_size = "10MB"

[performance]
enable_caching = true
cache_size = 1000

[logging]
level = "info"
format = "json"

import grpc
from bias_bindings import bias_pb2_grpc

# Configure connection options
options = [
    ('grpc.max_send_message_length', 10 * 1024 * 1024),  # 10MB
    ('grpc.max_receive_message_length', 10 * 1024 * 1024),
    ('grpc.keepalive_time_ms', 10000),
]

# Create channel with options
channel = grpc.insecure_channel('localhost:50051', options=options)
bias = bias_pb2_grpc.BiasServiceStub(channel)