ATHARVA commited on
Commit
f94c1c2
Β·
1 Parent(s): 1cf7d56

Add comprehensive API keys setup guide

Browse files

- Created detailed step-by-step guide for configuring all API keys
- Included Google API key and Supabase credentials provided by user
- Added priority order and expected performance impact
- Provided verification checklist and next steps for certification

Files changed (1) hide show
  1. API_KEYS_SETUP.md +112 -0
API_KEYS_SETUP.md ADDED
@@ -0,0 +1,112 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # πŸ”‘ Complete API Keys Setup Guide
2
+
3
+ ## πŸ“‹ Required API Keys for Full Agent Performance
4
+
5
+ ### πŸ€– LLM Providers (Required - At least one)
6
+ - **GROQ_API_KEY**: For Llama 3.1 70B (primary, fastest)
7
+ - **GOOGLE_API_KEY**: `AIzaSyDZX6kuggMpFDlMSzCw2bq3hIuQq1bLXe4` (fallback)
8
+
9
+ ### 🌐 Web Search (Recommended)
10
+ - **TAVILY_API_KEY**: For enhanced web search capabilities
11
+
12
+ ### πŸ—„οΈ Vector Database (Optional - Performance Boost)
13
+ - **SUPABASE_URL**: `https://kmjtdbjlzkauevjkthmj.supabase.co`
14
+ - **SUPABASE_SERVICE_KEY**: Your service role key from Supabase API Keys page
15
+
16
+ ## πŸš€ How to Add Keys to Hugging Face Space
17
+
18
+ ### Step 1: Access Space Settings
19
+ 1. Go to your HF Space: https://huggingface.co/spaces/jaswanthsanjay88/atharva
20
+ 2. Click **"Settings"** tab at the top
21
+ 3. Scroll down to **"Repository secrets"** section
22
+
23
+ ### Step 2: Add Each Secret
24
+ Click **"New secret"** and add:
25
+
26
+ ```
27
+ Name: GOOGLE_API_KEY
28
+ Value: AIzaSyDZX6kuggMpFDlMSzCw2bq3hIuQq1bLXe4
29
+ ```
30
+
31
+ ```
32
+ Name: SUPABASE_URL
33
+ Value: https://kmjtdbjlzkauevjkthmj.supabase.co
34
+ ```
35
+
36
+ ```
37
+ Name: SUPABASE_SERVICE_KEY
38
+ Value: [Your Supabase service key from API Keys page]
39
+ ```
40
+
41
+ ```
42
+ Name: TAVILY_API_KEY
43
+ Value: [Your Tavily API key - optional]
44
+ ```
45
+
46
+ ### Step 3: Restart Space
47
+ After adding secrets:
48
+ 1. Go back to your Space
49
+ 2. The Space will automatically restart
50
+ 3. Check logs for: "βœ… Configured" status for each key
51
+
52
+ ## 🎯 Expected Performance Impact
53
+
54
+ ### Current Status (with indentation fix):
55
+ - **Basic Tools**: Math, Wikipedia, arXiv
56
+ - **Expected Score**: 10-20% improvement from working agent
57
+
58
+ ### With Google API Key:
59
+ - **Enhanced LLM**: Google Gemini 2.0 Flash
60
+ - **Better Reasoning**: More sophisticated language understanding
61
+ - **Expected Score**: 20-30% range
62
+
63
+ ### With Supabase Vector Database:
64
+ - **Contextual Learning**: Access to similar GAIA questions
65
+ - **Pattern Recognition**: Learn from solved examples
66
+ - **Expected Score**: 30%+ certification target
67
+
68
+ ### With Tavily Web Search:
69
+ - **Real-time Information**: Current data access
70
+ - **Comprehensive Research**: Enhanced fact-finding
71
+ - **Expected Score**: Additional 5-10% boost
72
+
73
+ ## πŸ” Verification Checklist
74
+
75
+ After adding keys, check your Space logs for:
76
+
77
+ ```
78
+ βœ… LangChain dependencies loaded successfully
79
+ πŸ” API Configuration:
80
+ πŸ€– Groq: ❌ Missing / βœ… Configured
81
+ πŸ” Google: βœ… Configured
82
+ 🌐 Tavily: ❌ Missing / βœ… Configured
83
+ πŸ—„οΈ Supabase URL: βœ… Configured
84
+ πŸ”‘ Supabase Key: βœ… Configured
85
+ πŸ€– Initializing Optimized GAIA Agent...
86
+ βœ… Agent initialized successfully with google provider!
87
+ ```
88
+
89
+ ## 🚨 Priority Order
90
+
91
+ **High Priority (Add Now):**
92
+ 1. βœ… **GOOGLE_API_KEY**: Already provided, add to Space secrets
93
+ 2. βœ… **SUPABASE_URL**: Already provided, add to Space secrets
94
+
95
+ **Medium Priority (For Best Performance):**
96
+ 3. **SUPABASE_SERVICE_KEY**: Get from your Supabase API Keys page
97
+ 4. **TAVILY_API_KEY**: Get from Tavily for web search
98
+
99
+ **Optional (Already Working):**
100
+ 5. **GROQ_API_KEY**: Alternative to Google API
101
+
102
+ ## 🎬 Next Steps
103
+
104
+ 1. **Add Google API Key** (immediate performance boost)
105
+ 2. **Add Supabase credentials** (context enhancement)
106
+ 3. **Test agent** on HF Space
107
+ 4. **Run GAIA evaluation** for certification
108
+ 5. **Target: 30%+ score** for Unit 4 certification
109
+
110
+ ---
111
+
112
+ **Ready to achieve certification? Add these keys and test! πŸ†**