OpenEvidence Install & Auth Skill

OpenEvidence Install & Auth

Overview

Set up OpenEvidence Medical AI API for clinical decision support and evidence-based queries.

Prerequisites

OpenEvidence account and API access
API key/credentials from OpenEvidence dashboard
Node.js 18+ or Python 3.8+

Instructions

Step 1: Install SDK

npm install @openevidence/sdk
# API key from OpenEvidence developer portal

Step 2: Configure Authentication

export OPENEVIDENCE_API_KEY="your-api-key-here"
echo 'OPENEVIDENCE_API_KEY=your-api-key' >> .env

Step 3: Verify Connection (TypeScript)

import { OpenEvidenceClient } from '@openevidence/sdk';
const client = new OpenEvidenceClient({
  apiKey: process.env.OPENEVIDENCE_API_KEY,
  organization: process.env.OPENEVIDENCE_ORG_ID
});
const result = await client.query({ question: 'What are first-line treatments for Type 2 diabetes?' });
console.log(`Answer: ${result.answer.substring(0, 100)}...`);
console.log(`Citations: ${result.citations.length} references`);

Step 4: Verify Connection (Python)

import openevidence
client = openevidence.Client(api_key=os.environ['OPENEVIDENCE_API_KEY'])
result = client.query(question='What are first-line treatments for Type 2 diabetes?')
print(f'Answer: {result.answer[:100]}...')
print(f'Citations: {len(result.citations)} references')

Error Handling

| Error | Code | Solution | |-------|------|----------| | Invalid API key | 401 | Verify credentials in dashboard | | Permission denied | 403 | Check API scopes/permissions | | Rate limited | 429 | Implement backoff |

Resources

OpenEvidence Documentation

Next Steps

After auth, proceed to openevidence-hello-world.

Agent Skills: OpenEvidence Install & Auth

Install this agent skill to your local

Skill Files