# Onairos LLM Installation Instructions
# Copy this entire file to your AI assistant or code agent

## Overview
Onairos provides user personality data and personalization APIs for your applications.

---

## Web Installation (React/Next.js/Vue/Angular)

### Step 1: Install the package
```bash
npm install onairos
```

### Step 2: Import and initialize
```javascript
import Onairos from 'onairos';

const onairos = new Onairos({
  apiKey: 'YOUR_API_KEY',
});
```

### Step 3: Add the Onairos button to request user data
```javascript
const requestedData = {
  type: 'Personality',
  name: 'Personality Analysis',
  description: 'Deep analysis of your Personality for recommendations',
  reward: 'Personalized experience'
};

onairos.open({
  requestedData,
  onSuccess: (data) => {
    console.log('User data received:', data);
    // Use data.accessToken to fetch personality traits
  },
  onError: (error) => {
    console.error('Error:', error);
  }
});
```

### Step 4: Fetch user traits with the access token
```javascript
const response = await fetch('https://api.onairos.uk/traits', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Bearer ${accessToken}`
  }
});
const traits = await response.json();
```

---

## Mobile Installation (React Native)

### Step 1: Install
```bash
npm install onairos-react-native
```

### Step 2: Initialize in your app
```javascript
import { OnairosProvider, OnairosButton } from 'onairos-react-native';

function App() {
  return (
    <OnairosProvider apiKey="YOUR_API_KEY">
      <OnairosButton 
        requestedData={{ type: 'Personality' }}
        onSuccess={(data) => console.log(data)}
      />
    </OnairosProvider>
  );
}
```

---

## Mobile Installation (Flutter)

### Step 1: Add to pubspec.yaml
```yaml
dependencies:
  onairos: ^1.0.0
```

### Step 2: Initialize
```dart
import 'package:onairos/onairos.dart';

final onairos = Onairos(apiKey: 'YOUR_API_KEY');

// Request user data
await onairos.open(
  requestedData: RequestedData(
    type: 'Personality',
    description: 'Personalized recommendations'
  ),
  onSuccess: (data) => print(data),
);
```

---

## Human API (LLM Enhancement)

Automatically inject user context into any LLM call:

```javascript
const response = await fetch('https://api.onairos.uk/human', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    userId: 'user_123',
    model: 'gpt-4',
    messages: [
      { role: 'user', content: 'Recommend me a movie' }
    ]
  })
});

// Response includes user personality context automatically
const result = await response.json();
```

---

## API Endpoints

Base URL: https://api.onairos.uk

| Endpoint | Method | Description |
|----------|--------|-------------|
| /traits | POST | Get user personality traits |
| /sentiment | POST | Get sentiment prediction |
| /human | POST | LLM call with user context |
| /memories | GET | Get user memories |

---

## Get API Key

1. Visit https://onairos.uk
2. Sign up / Sign in
3. Go to Developer Dashboard
4. Create new API key

---

## Documentation
Full docs: https://docs.onairos.uk

## Support
Email: support@onairos.uk