QUICK_START_CEREBRAS.md

⚡ Quick Start: Cerebras Setup

🎯 What You Need to Do RIGHT NOW

Step 1: Add Your API Key (2 minutes)

You mentioned you already have a Cerebras API key. Let's add it!

Edit the .env file:

cd "/Users/niro/Documents/SL Clinical Assistant"
nano .env

Replace <YOUR_CEREBRAS_API_KEY_HERE> with your actual Cerebras API key.

It should look like:

CEREBRAS_API_KEY=csk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Save and exit (Ctrl+X, then Y, then Enter).

---

Step 2: Install Cerebras SDK (1 minute)

pip install cerebras-cloud-sdk

---

Step 3: Test Locally (2 minutes)

# Make sure you're in the right directory
cd "/Users/niro/Documents/SL Clinical Assistant"

# Run the app
python app.py

Expected output:

🏥 Initializing VedaMD Enhanced for Hugging Face Spaces...
✅ Cerebras API connection successful
✅ Enhanced Medical RAG system ready!
Running on local URL:  http://127.0.0.1:7860

Open http://localhost:7860 in your browser.

---

Step 4: Test Query (1 minute)

In the chat interface, type:

What is preeclampsia?

You should see:

• ⚡ Response in < 3 seconds (much faster than Groq!)
• Medical sources/citations
• Verification status

---

Step 5: Deploy to HF Spaces (5 minutes)

Once local testing works:

1. Add API key to HF Spaces:

   • Go to your Space Settings
   • Repository secrets → Add secret
   • Name: CEREBRAS_API_KEY
   • Value: Your Cerebras API key

2. Push code:

   git add .
   git commit -m "feat: Migrate to Cerebras for ultra-fast inference"
   git push origin main
   

3. Watch logs in HF Spaces for successful deployment

---

🎉 Done!

Total time: 10-15 minutes

Your app is now:

• ⚡ 7x faster (2000+ tps vs 280 tps)
• 💰 FREE (no more API costs!)
• 🚀 Production-ready

---

🐛 If Something Goes Wrong

Error: "CEREBRAS_API_KEY not found"

# Check if key is set
cat .env

# Make sure it says:
CEREBRAS_API_KEY=csk-...

Error: "No module named 'cerebras'"

pip install cerebras-cloud-sdk

Error: "Invalid API key"

• Double-check your key at https://cloud.cerebras.ai
• Make sure it starts with csk-
• No spaces or quotes in .env file

---

📖 More Help

• Full guide: See CEREBRAS_MIGRATION_GUIDE.md
• Deployment: See DEPLOYMENT.md
• Security: See SECURITY_SETUP.md

---

Ready? Let's go! 🚀