Revised to reflect updates

Author: AvantMaker

README.md

@@ -18,6 +18,7 @@ Visit us at [AvantMaker.com](https://www.avantmaker.com) where we've crafted a c
 ESP32_AI_Connect is an Arduino library that enables ESP32 microcontrollers to interact seamlessly with popular AI APIs including:
 - OpenAI
 - Google Gemini
+- Anthroic Claude
 - DeepSeek
 - OpenAI-Compatible (HuggingFace, Qwen, etc.)
 - And more to be included...
@@ -49,7 +50,7 @@ ESP32_AI_Connect is an Arduino library that enables ESP32 microcontrollers to in
 | Anthropic Claude | `"claude"`| claude-3.7-sonnet, claude-3.5-haiku, etc.               | Yes               | Under Development                |
 | OpenAI Compatible | `"openai-compatible"`| HuggingFace, Qwen, etc.                       | See Note 1 below               | Under Development               |
 
-**Note 1:** Support for tool calls varies across platforms and models. Therefore, the availability of the `tool_calls` functionality of the OpenAI Compatible platform depends on the specific platform and model you select.
+**Note 1:** Tool call support differs by platform and model, so the availability of the `tool_calls` feature on the OpenAI Compatible platform depends on your chosen platform and model.
 
 **Note 2:** We are actively working to add Grok and Ollama to the list of supported platforms.
 
@@ -88,10 +89,10 @@ const char* password = "your_PASSWORD"; // Your WiFi password
 const char* apiKey = "your_API_KEY";    // Your OpenAI API key (keep this secure!)
 
 // Initialize AI client with:
-// 1. Platform identifier ("openai", "gemini", or "deepseek")
+// 1. Platform identifier ("openai", "gemini", "claude", or "deepseek")
 // 2. Your API key
 // 3. Model name ("gpt-3.5-turbo" for this example)
-ESP32_AI_Connect ai("openai", apiKey, "gpt-3.5-turbo");
+ESP32_AI_Connect aiClient("openai", apiKey, "gpt-3.5-turbo");
 
 void setup() {
   // Initialize serial communication for debugging
@@ -109,33 +110,34 @@ void setup() {
 
   // WiFi connected - print IP address
   Serial.println("\nWiFi connected!");
-  Serial.print("IP address: ");
-  Serial.println(WiFi.localIP());
 
-  // Configure AI client parameters:
-  ai.setChatTemperature(0.7);       // Set response creativity (0.0-2.0)
-  ai.setChatMaxTokens(200);         // Limit response length (in tokens)
-  ai.setChatSystemRole("You are a helpful assistant");  // Set assistant behavior
+  // Optional: You can use the following methods to Configure AI client parameters, such as
+  //           System Role, Max Tokens, etc. 
+  //           The LLM will use default values when interacting with AI Client if these parameters
+  //           are not set.
+  aiClient.setChatTemperature(0.7);       // Set response creativity (0.0-2.0)
+  aiClient.setChatMaxTokens(200);         // Limit response length (in tokens)
+  aiClient.setChatSystemRole("You are a helpful assistant");  // Set assistant behavior
 
   // You can retrieve current settings using getter methods:
   Serial.print("Current temperature: ");
-  Serial.println(ai.getChatTemperature());
+  Serial.println(aiClient.getChatTemperature());
   Serial.print("Maximum tokens: ");
-  Serial.println(ai.getChatMaxTokens());
+  Serial.println(aiClient.getChatMaxTokens());
   Serial.print("System role: ");
-  Serial.println(ai.getChatSystemRole());
+  Serial.println(aiClient.getChatSystemRole());
 
   // Send a test message to the AI and get response
   Serial.println("\nSending message to AI...");
-  String response = ai.chat("Hello! Who are you?");
+  String response = aiClient.chat("Hello! Who are you?");
 
   // Print the AI's response
   Serial.println("\nAI Response:");
   Serial.println(response);
 
   // Check for errors (empty response indicates an error occurred)
   if (response.isEmpty()) {
-    Serial.println("Error: " + ai.getLastError());
+    Serial.println("Error: " + aiClient.getLastError());
   }
 }
 

doc/User Guides/1 Introduction.md

@@ -1,12 +1,12 @@
 # ESP32_AI_Connect Library User Guide - 1 Introduction
-> **Version 0.0.2** • Revised: May 09, 2025 • Author: AvantMaker • [https://www.AvantMaker.com](https://www.AvantMaker.com)
+> **Version 0.0.3** • Revised: May 10, 2025 • Author: AvantMaker • [https://www.AvantMaker.com](https://www.AvantMaker.com)
 ## Overview
 
 ESP32_AI_Connect is a powerful, flexible library designed to connect ESP32 microcontrollers to various Large Language Model (LLM) platforms. This library simplifies the process of integrating AI capabilities into your ESP32 projects, allowing you to create intelligent IoT devices, smart assistants, and interactive applications with minimal effort.
 
 ## Key Features
 
-- **Multi-Platform Support**: Connect to multiple AI platforms including OpenAI, Google Gemini, and DeepSeek
+- **Multi-Platform Support**: Connect to multiple AI platforms including OpenAI, Anthropic Claude, Google Gemini, and DeepSeek
 - **Simple API**: Easy-to-use interface for sending prompts and receiving responses
 - **Tool Calls Support**: Enable your ESP32 to use LLM function calling capabilities
 - **Memory Efficient**: Optimized for the limited resources of ESP32 devices
@@ -31,7 +31,7 @@ The library follows a well-structured design pattern:
 
 1. **ESP32_AI_Connect**: The main class that users interact with
 2. **AI_API_Platform_Handler**: An abstract base class that defines a common interface for all AI platforms
-3. **Platform-Specific Handlers**: Implementations for each supported AI platform (OpenAI, Gemini, DeepSeek)
+3. **Platform-Specific Handlers**: Implementations for each supported AI platform (OpenAI, Gemini, DeepSeek, Anthropic, etc.)
 
 This architecture allows you to switch between different AI platforms with minimal code changes, while also making it easy to extend the library with support for new platforms.
 
@@ -41,10 +41,10 @@ To use ESP32_AI_Connect in your project, you'll need:
 
 - An ESP32 development board
 - Arduino IDE or PlatformIO
-- An API key for your chosen AI platform (OpenAI, Google Gemini, or DeepSeek)
+- An API key for your chosen AI platform (OpenAI, Google Gemini, Anropic Claude or DeepSeek)
 - WiFi connectivity
 
-The library can be installed through the Arduino Library Manager or by downloading the source code from the repository.
+The library can be installed by downloading the source code from the repository.
 
 ## Basic Usage Example
 
@@ -65,10 +65,10 @@ const char* password = "your_PASSWORD"; // Your WiFi password
 const char* apiKey = "your_API_KEY";    // Your OpenAI API key (keep this secure!)
 
 // Initialize AI client with:
-// 1. Platform identifier ("openai", "gemini", or "deepseek")
+// 1. Platform identifier ("openai", "gemini", "claude", or "deepseek")
 // 2. Your API key
 // 3. Model name ("gpt-3.5-turbo" for this example)
-ESP32_AI_Connect ai("openai", apiKey, "gpt-3.5-turbo");
+ESP32_AI_Connect aiClient("openai", apiKey, "gpt-3.5-turbo");
 
 void setup() {
   // Initialize serial communication for debugging
@@ -86,25 +86,34 @@ void setup() {
 
   // WiFi connected - print IP address
   Serial.println("\nWiFi connected!");
-  Serial.print("IP address: ");
-  Serial.println(WiFi.localIP());
 
-  // Configure AI client parameters:
-  ai.setTemperature(0.7);       // Set response creativity (0.0-2.0)
-  ai.setMaxTokens(200);         // Limit response length (in tokens)
-  ai.setSystemRole("You are a helpful assistant");  // Set assistant behavior
+  // Optional: You can use the following methods to Configure AI client parameters, such as
+  //           System Role, Max Tokens, etc. 
+  //           The LLM will use default values when interacting with AI Client if these parameters
+  //           are not set.
+  aiClient.setChatTemperature(0.7);       // Set response creativity (0.0-2.0)
+  aiClient.setChatMaxTokens(200);         // Limit response length (in tokens)
+  aiClient.setChatSystemRole("You are a helpful assistant");  // Set assistant behavior
+  
+  // You can retrieve current settings using getter methods:
+  Serial.print("Current temperature: ");
+  Serial.println(aiClient.getChatTemperature());
+  Serial.print("Maximum tokens: ");
+  Serial.println(aiClient.getChatMaxTokens());
+  Serial.print("System role: ");
+  Serial.println(aiClient.getChatSystemRole());
 
   // Send a test message to the AI and get response
   Serial.println("\nSending message to AI...");
-  String response = ai.chat("Hello! Who are you?");
+  String response = aiClient.chat("Hello! Who are you?");
 
   // Print the AI's response
   Serial.println("\nAI Response:");
   Serial.println(response);
 
   // Check for errors (empty response indicates an error occurred)
   if (response.isEmpty()) {
-    Serial.println("Error: " + ai.getLastError());
+    Serial.println("Error: " + aiClient.getLastError());
   }
 }
 
@@ -119,7 +128,7 @@ void loop() {
 This introduction provides a high-level overview of the ESP32_AI_Connect library. In the following guides, we'll explore:
 
 1. **Basic Chat with LLMs**: How to set up and conduct conversations with different AI models
-2. **Tool Calls**: How to enable your ESP32 to use LLM function calling capabilities
+2. **Tool Calls**: How to enable your ESP32 to use LLM tool calling capabilities
 3. And more as new features are added
 
 Each guide will include detailed explanations, code examples, and best practices to help you get the most out of the ESP32_AI_Connect library.

doc/User Guides/2 Basic LLM Chat Implementation.md

@@ -1,5 +1,5 @@
 # ESP32_AI_Connect Library User Guide - 2 Basic LLM Chat Implementation
-> **Version 0.0.2** • Revised: May 09, 2025 • Author: AvantMaker • [https://www.AvantMaker.com](https://www.AvantMaker.com)
+> **Version 0.0.3** • Revised: May 10, 2025 • Author: AvantMaker • [https://www.AvantMaker.com](https://www.AvantMaker.com)
 
 ## Overview
 
@@ -13,7 +13,7 @@ Before you begin, make sure you have:
 - Arduino IDE installed with ESP32 board support
 - ESP32_AI_Connect library installed
 - WiFi connectivity
-- An API key for your chosen AI platform (OpenAI, Google Gemini, or DeepSeek)
+- An API key for your chosen AI platform (OpenAI, Google Gemini, Anthropic Claude or DeepSeek)
 
 ## Step 1: Include Required Libraries
 
@@ -48,11 +48,11 @@ Now we create an instance of the `ESP32_AI_Connect` class:
 // 1. Platform identifier ("openai", "gemini", or "deepseek")
 // 2. Your API key
 // 3. Model name ("gpt-3.5-turbo" for this example)
-ESP32_AI_Connect ai("openai", apiKey, "gpt-3.5-turbo");
+ESP32_AI_Connect aiClient("openai", apiKey, "gpt-3.5-turbo");
 ```
 
 This line initializes the AI client with three parameters:
-- The platform identifier (`"openai"` in this example, but you can also use `"gemini"` or `"deepseek"`)
+- The platform identifier (`"openai"` in this example, but you can also use `"gemini"`, `"claude"`, `"deepseek"` or `"openai-compatible"`)
 - Your API key
 - The model name (`"gpt-3.5-turbo"` for OpenAI)
 
@@ -93,9 +93,9 @@ After establishing the WiFi connection, we configure the AI client with specific
 
 ```cpp:basic_example.ino
   // Configure AI client parameters:
-  ai.setChatTemperature(0.7);       // Set response creativity (0.0-2.0)
-  ai.setChatMaxTokens(200);         // Limit response length (in tokens)
-  ai.setChatSystemRole("You are a helpful assistant");  // Set assistant behavior
+  aiClient.setChatTemperature(0.7);       // Set response creativity (0.0-2.0)
+  aiClient.setChatMaxTokens(200);         // Limit response length (in tokens)
+  aiClient.setChatSystemRole("You are a helpful assistant");  // Set assistant behavior
 ```
 
 These configuration options allow you to customize the behavior of the AI:
@@ -104,6 +104,9 @@ These configuration options allow you to customize the behavior of the AI:
 - `setChatMaxTokens(200)`: Limits the maximum length of the AI's response in tokens (roughly 4 characters per token). This helps control response size and API costs.
 - `setChatSystemRole("You are a helpful assistant")`: Sets the system message that defines the AI's behavior and personality.
 
+**Note: The parameters set by the above methods are optional. If you do not explicitly configure these parameters, the LLM will use its default values for temperature, max tokens, and system role.**
+
+
 ## Step 6: Verifying Configuration with Getter Methods
 
 You can verify your configuration settings using the corresponding getter methods:
@@ -112,11 +115,11 @@ You can verify your configuration settings using the corresponding getter method
   // Retrieve and display the current configuration
   Serial.println("\nAI Configuration:");
   Serial.print("System Role: ");
-  Serial.println(ai.getChatSystemRole());
+  Serial.println(aiClient.getChatSystemRole());
   Serial.print("Temperature: ");
-  Serial.println(ai.getChatTemperature());
+  Serial.println(aiClient.getChatTemperature());
   Serial.print("Max Tokens: ");
-  Serial.println(ai.getChatMaxTokens());
+  Serial.println(aiClient.getChatMaxTokens());
 ```
 
 These getter methods allow you to:
@@ -131,21 +134,21 @@ Now we're ready to send a message to the AI and receive a response:
 ```cpp:basic_example.ino
   // Send a test message to the AI and get response
   Serial.println("\nSending message to AI...");
-  String response = ai.chat("Hello! Who are you?");
+  String response = aiClient.chat("Hello! Who are you?");
 
   // Print the AI's response
   Serial.println("\nAI Response:");
   Serial.println(response);
 
   // Check for errors (empty response indicates an error occurred)
   if (response.isEmpty()) {
-    Serial.println("Error: " + ai.getLastError());
+    Serial.println("Error: " + aiClient.getLastError());
   }
 }
 ```
 
-The key function here is `ai.chat()`, which:
-1. Takes a string parameter containing your message to the AI
+The key function here is `aiClient.chat()`, which:
+1. Takes a string parameter containing your prompt message to the AI
 2. Sends the request to the AI platform
 3. Returns the AI's response as a string
 
@@ -182,7 +185,7 @@ void loop() {
 
       // Send the message to the AI
       Serial.println("Sending to AI...");
-      String response = ai.chat(userMessage);
+      String response = aiClient.chat(userMessage);
 
       // Print the AI's response
       Serial.println("AI: " + response);
@@ -212,16 +215,16 @@ If you need to reset the chat configuration to default values, you can use the `
 
 ```cpp
 // Reset chat configuration to defaults
-ai.chatReset();
+aiClient.chatReset();
 
 // Verify reset was successful
 Serial.println("After reset:");
 Serial.print("System Role: ");
-Serial.println(ai.getChatSystemRole());  // Should be empty
+Serial.println(aiClient.getChatSystemRole());  // Should be empty
 Serial.print("Temperature: ");
-Serial.println(ai.getChatTemperature());  // Should be -1.0 (default)
+Serial.println(aiClient.getChatTemperature());  // Should be -1.0 (default)
 Serial.print("Max Tokens: ");
-Serial.println(ai.getChatMaxTokens());    // Should be -1 (default)
+Serial.println(aiClient.getChatMaxTokens());    // Should be -1 (default)
 ```
 
 This is useful when you want to start a fresh conversation with different settings or return to the default configuration.
@@ -232,12 +235,17 @@ One of the key features of the ESP32_AI_Connect library is its ability to work w
 
 ### For Google Gemini:
 ```cpp
-ESP32_AI_Connect ai("gemini", apiKey, "gemini-2.0.flash");
+ESP32_AI_Connect aiClient("gemini", apiKey, "gemini-2.0.flash");
+
+```
+### For Anthropic Claude:
+```cpp
+ESP32_AI_Connect aiClient("claude", apiKey, "claude-3.7-sonnet");
 ```
 
 ### For DeepSeek:
 ```cpp
-ESP32_AI_Connect ai("deepseek", apiKey, "deepseek-chat");
+ESP32_AI_Connect aiClient("deepseek", apiKey, "deepseek-chat");
 ```
 
 Make sure the corresponding platform is enabled in the `ESP32_AI_Connect_config.h` file:
@@ -247,31 +255,34 @@ Make sure the corresponding platform is enabled in the `ESP32_AI_Connect_config.
 #define USE_AI_API_OPENAI        // Enable OpenAI and OpenAI-compatible APIs
 #define USE_AI_API_GEMINI        // Enable Google Gemini API
 #define USE_AI_API_DEEPSEEK      // Enable DeepSeek API
+#define USE_AI_API_CLAUDE        // Enable Anthropic Claude API
 ```
 
 ## Using a Custom Endpoint
 
-If you're using an OpenAI compatible API that requires a custom endpoint URL, you can use the alternative constructor:
+If you're using an OpenAI compatible API that requires a custom endpoint URL, you can use the alternative constructor :
 
 ```cpp
 const char* customEndpoint = "https://your-custom-endpoint.com/v1/chat/completions";
-ESP32_AI_Connect ai("openai-compatible", apiKey, "model-name", customEndpoint);
+ESP32_AI_Connect aiClient("openai-compatible", apiKey, "model-name", customEndpoint);
 ```
 
 This is useful for self-hosted models or alternative API providers that are compatible with the OpenAI API format.
 
+For more detailed information on how to use OpenAI compatible API, please refer to the custom_llm_chat.ino example code in the examples folder of the ESP32_AI_Connect Library. 
+
 ## Accessing Raw API Responses
 
 For advanced usage, you might want to access the complete raw JSON response from the API. The library provides methods to retrieve these:
 
 ```cpp
 // Get the raw JSON response from the last chat request
-String rawResponse = ai.getChatRawResponse();
+String rawResponse = aiClient.getChatRawResponse();
 Serial.println("Raw API Response:");
 Serial.println(rawResponse);
 
 // For tool calling, you can also get the raw response
-String rawToolResponse = ai.getTCRawResponse();
+String rawToolResponse = aiClient.getTCRawResponse();
 ```
 
 These methods allow you to access the full API response data for custom processing or debugging.
@@ -280,7 +291,7 @@ These methods allow you to access the full API response data for custom processi
 
 If you encounter issues with your AI chat application, here are some common problems and solutions:
 
-1. **Empty Response**: If `ai.chat()` returns an empty string, check `ai.getLastError()` for details about what went wrong.
+1. **Empty Response**: If `aiClient.chat()` returns an empty string, check `aiClient.getLastError()` for details about what went wrong.
 
 2. **WiFi Connection Issues**: Make sure your WiFi credentials are correct and that your ESP32 is within range of your WiFi network.