aura-labs.ai

AURA Examples

Complete integration examples demonstrating AURA in various environments.

Example Projects

Node.js Examples (`/nodejs`)

Example	Description
`basic-integration/`	Minimal Beacon setup
`ecommerce-platform/`	Full e-commerce integration
`marketplace-integration/`	Multi-vendor marketplace

Python Examples (`/python`)

Example	Description
`flask-beacon/`	Flask-based Beacon
`django-beacon/`	Django integration
`ml-pricing-engine/`	ML-powered dynamic pricing

Go Examples (`/go`) (Coming Soon)

Example	Description
`high-performance-beacon/`	Optimized for throughput
`microservices-beacon/`	Distributed architecture

Running Examples

Each example includes:

README.md with setup instructions
package.json or equivalent
.env.example for configuration
Working code you can run immediately

General Steps

# Navigate to example
cd nodejs/basic-integration

# Install dependencies
npm install

# Configure
cp .env.example .env
# Edit .env with your credentials

# Run
npm start

Example Walkthroughs

Basic Integration (Node.js)

The simplest possible Beacon integration:

import { createBeacon } from '@aura-labs-ai/beacon';

const beacon = createBeacon({
  externalId: 'my-store-001',
  name: 'My Store',
  endpointUrl: 'https://mystore.com/webhook',
  capabilities: ['retail', 'shipping'],
  coreUrl: 'https://core.aura-labs.io'
});

await beacon.register();

beacon.onSession(async (session, beacon) => {
  const product = findProduct(session.intent.parsed);
  if (product) {
    await beacon.submitOffer(session.sessionId, {
      product: product.name,
      unitPrice: product.price,
      quantity: session.intent.parsed.quantity || 1,
      currency: 'USD',
      deliveryDate: '2026-03-10'
    });
  }
});

await beacon.startPolling();

E-commerce Platform Integration

Shows how to:

Sync inventory from database
Handle real orders
Manage fulfillment
Track analytics

ML Pricing Engine (Python)

Demonstrates:

Training pricing models
Real-time price optimization
A/B testing strategies
Performance monitoring

Creating Your Own Example

We welcome community examples! To contribute:

Create a new folder under the appropriate language
Include a comprehensive README
Add working, tested code
Submit a pull request

See CONTRIBUTING.md for guidelines.