Skip to content

configuration.mdx

Latest commit

 

History

History
93 lines (71 loc) · 2.25 KB

configuration.mdx

File metadata and controls

93 lines (71 loc) · 2.25 KB
title Configuration
description Environment variables and initialization options
## Environment Variables 
```bash
FALLOM_API_KEY=your-api-key
FALLOM_BASE_URL=https://spans.fallom.com  # or http://localhost:8001 for local dev
```

## Initialization Options

```python
fallom.init(
    api_key="your-api-key",      # Or use FALLOM_API_KEY env var
    base_url="https://spans.fallom.com",  # Or use FALLOM_BASE_URL env var
    capture_content=True         # Set False for privacy mode
)
```

## Privacy Mode

For companies with strict data policies, disable prompt/completion capture:

```python
# Via parameter
fallom.init(capture_content=False)

# Or via environment variable
FALLOM_CAPTURE_CONTENT=false
```

In privacy mode, Fallom still tracks:

| Captured | Not Captured |
| -------- | ------------ |
| ✅ Model used | ❌ Prompt content |
| ✅ Token counts | ❌ Completion content |
| ✅ Latency | |
| ✅ Session/config context | |
| ✅ Prompt key/version (metadata only) | |
## Environment Variables 
```bash
FALLOM_API_KEY=your-api-key
FALLOM_BASE_URL=https://spans.fallom.com
FALLOM_CAPTURE_CONTENT=true  # set to "false" for privacy mode
```

## Privacy Mode

Disable prompt/completion capture:

```typescript
fallom.init({ captureContent: false });
```

In privacy mode, Fallom still tracks:

| Captured | Not Captured |
| -------- | ------------ |
| ✅ Model used | ❌ Prompt content |
| ✅ Token counts | ❌ Completion content |
| ✅ Latency | |
| ✅ Session/config context | |
| ✅ Prompt key/version (metadata only) | |

Get Your API Key

Get your API key from project settings

Next Steps

Test different models to optimize cost and performance. Experiment with prompts to improve outputs.