Framework for orchestrating role-playing, autonomous AI agents. By fostering collaborative intelligence, CrewAI empowers agents to work together seamlessly, tackling complex tasks.
feat: add native Gemini 3.8 Flash support (#7284)
mairaarshad19b9629cfb8ff9
diff --git a/lib/cli/src/crewai_cli/constants.py b/lib/cli/src/crewai_cli/constants.pyindex c587147b3..c7b902b2a 100644--- a/lib/cli/src/crewai_cli/constants.py+++ b/lib/cli/src/crewai_cli/constants.py@@ -177,6 +177,7 @@ MODELS: dict[str, list[str]] = {"claude-haiku-4-5-20251001",],"gemini": [+ "gemini/gemini-3.8-flash","gemini/gemini-3-pro-preview","gemini/gemini-1.5-flash","gemini/gemini-1.5-pro",diff --git a/lib/cli/src/crewai_cli/create_json_crew.py b/lib/cli/src/crewai_cli/create_json_crew.pyindex 3c7a0dba4..1586ba52a 100644--- a/lib/cli/src/crewai_cli/create_json_crew.py+++ b/lib/cli/src/crewai_cli/create_json_crew.py@@ -75,6 +75,7 @@ _PROVIDER_MODELS: dict[str, list[tuple[str, str]]] = {("claude-sonnet-4-6", "Claude Sonnet 4.6"),],"gemini": [+ ("gemini-3.8-flash", "Gemini 3.8 Flash"),("gemini-3.5-flash", "Gemini 3.5 Flash"),("gemini-3.1-pro-preview", "Gemini 3.1 Pro (preview)"),("gemini-3-flash-preview", "Gemini 3 Flash (preview)"),diff --git a/lib/crewai/src/crewai/constants.py b/lib/crewai/src/crewai/constants.pyindex 237a54dbc..84a10642d 100644--- a/lib/crewai/src/crewai/constants.py+++ b/lib/crewai/src/crewai/constants.py@@ -173,6 +173,7 @@ MODELS: dict[str, list[str]] = {"claude-haiku-4-5-20251001",],"gemini": [+ "gemini/gemini-3.8-flash","gemini/gemini-3-pro-preview","gemini/gemini-1.5-flash","gemini/gemini-1.5-pro",diff --git a/lib/crewai/src/crewai/llm.py b/lib/crewai/src/crewai/llm.pyindex 0c95e3ddd..64d86403e 100644--- a/lib/crewai/src/crewai/llm.py+++ b/lib/crewai/src/crewai/llm.py@@ -181,6 +181,7 @@ LLM_CONTEXT_WINDOW_SIZES: Final[dict[str, int]] = {"o1-mini": 128000,"o3-mini": 200000,"o4-mini": 200000,+ "gemini-3.8-flash": 1048576,"gemini-3-pro-preview": 1048576,"gemini-2.0-flash": 1048576,"gemini-2.0-flash-thinking-exp-01-21": 32768,diff --git a/lib/crewai/src/crewai/llms/constants.py b/lib/crewai/src/crewai/llms/constants.pyindex 20697f6a5..b26a9e3e2 100644--- a/lib/crewai/src/crewai/llms/constants.py+++ b/lib/crewai/src/crewai/llms/constants.py@@ -213,6 +213,7 @@ ANTHROPIC_MODELS: list[AnthropicModels] = []GeminiModels: TypeAlias = Literal[+ "gemini-3.8-flash","gemini-3-pro-preview","gemini-3-flash-preview","gemini-2.5-pro",@@ -268,6 +269,7 @@ GeminiModels: TypeAlias = Literal["learnlm-2.0-flash-experimental",]GEMINI_MODELS: list[GeminiModels] = [+ "gemini-3.8-flash","gemini-3-pro-preview","gemini-3-flash-preview","gemini-2.5-pro",diff --git a/lib/crewai/src/crewai/llms/providers/gemini/completion.py b/lib/crewai/src/crewai/llms/providers/gemini/completion.pyindex 68fc9d4d7..6ca6da229 100644--- a/lib/crewai/src/crewai/llms/providers/gemini/completion.py+++ b/lib/crewai/src/crewai/llms/providers/gemini/completion.py@@ -1394,6 +1394,7 @@ class GeminiCompletion(BaseLLM):)context_windows = {+ "gemini-3.8-flash": 1048576, # 1M tokens"gemini-3-pro-preview": 1048576, # 1M tokens"gemini-2.0-flash": 1048576, # 1M tokens"gemini-2.0-flash-thinking": 32768,diff --git a/lib/crewai/tests/cassettes/test_gemini_models[gemini-gemini-3.8-flash].yaml b/lib/crewai/tests/cassettes/test_gemini_models[gemini-gemini-3.8-flash].yamlnew file mode 100644index 000000000..fc4ccecfb--- /dev/null+++ b/lib/crewai/tests/cassettes/test_gemini_models[gemini-gemini-3.8-flash].yaml@@ -0,0 +1,77 @@+interactions:+- request:+ body: '{"contents": [{"parts": [{"text": "What is the capital of France?"}], "role":+ "user"}], "generationConfig": {"thinkingConfig": {"include_thoughts": true}}}'+ headers:+ User-Agent:+ - X-USER-AGENT-XXX+ accept:+ - '*/*'+ accept-encoding:+ - ACCEPT-ENCODING-XXX+ connection:+ - keep-alive+ content-length:+ - '155'+ content-type:+ - application/json+ host:+ - generativelanguage.googleapis.com+ x-goog-api-client:+ - google-genai-sdk/1.65.0 gl-python/3.13.15+ x-goog-api-key:+ - X-GOOG-API-KEY-XXX+ method: POST+ uri: https://generativelanguage.googleapis.com/v1beta/models/gemini-3.8-flash:generateContent+ response:+ body:+ string: "{\n \"candidates\": [\n {\n \"content\": {\n \"parts\":+ [\n {\n \"text\": \"**My Thought Process: Providing a+ Direct Answer**\\n\\nOkay, so the user wants to know the capital of France.+ Right, straightforward enough. My first step is to *immediately* identify+ the central question: \\\"Capital of France?\\\" That's the core. No need+ for fluff or ambiguity; clarity is key here, especially for someone who, presumably,+ knows what they're looking for.\\n\\nNext, I need to retrieve the relevant+ knowledge. Capital of France... Paris. Simple fact. Solidly established. No+ debate.\\n\\nNow, how do I formulate the response? The user is likely very+ well-versed in the specifics of cities and government, so I'll keep it concise+ and accurate. A direct answer is all that's required. \\\"The capital of France+ is Paris.\\\" That's it. Succinct, complete, and correct. Done.\\n\\n\\n\",\n+ \ \"thought\": true\n },\n {\n \"text\":+ \"The capital of France is **Paris**.\",\n \"thoughtSignature\":+ \"EvUCCvICARFNMg8/4vvgyvFJnrzbczsj7uopma+hWpxZcfOjV0xuUc1aITo6NeNf3RNqb5f2TSPIbgZk4wempJOb2ZXI10ZGI9LmUi8uPKNHFKA0k4cbcUET6Y8eU18ymoOFAcBlIN7saWJm01yINKBkQSend2K9uoR1T94P8Q65JbGkcxKzOOoWe3c5Q66vonBxWmu++FxsWKmk2U8Spg1spMnZarzZJsl/mN0L3FY3fkejV5+i8EywJ8sU282s+Er6PnIfwV1Dmi08Ut3JsboqsiT4CFyp5uwBUqqo3soWa66tA0iV0I/S3nR2SSjWGb2XvLB1v/M1TxPWYkTuCSViRurPtT6MELSTYP+NwJ3UXqzj0amQhIPjXpXqozgSZZUDhPo4gMGr0b8sHp7uaqKOTt/PISw4211XDk4QLEcvZklozAoDggoqwXPUWsQUQqNUQxMP0rJZrNU7Zd04HKjVkFIM9BTvEaNhjMwrRCRrPMrXWYz1Pg==\"\n+ \ }\n ],\n \"role\": \"model\"\n },\n \"finishReason\":+ \"STOP\",\n \"index\": 0\n }\n ],\n \"usageMetadata\": {\n \"promptTokenCount\":+ 8,\n \"candidatesTokenCount\": 8,\n \"totalTokenCount\": 80,\n \"promptTokensDetails\":+ [\n {\n \"modality\": \"TEXT\",\n \"tokenCount\": 8\n }\n+ \ ],\n \"thoughtsTokenCount\": 64,\n \"serviceTier\": \"standard\"\n+ \ },\n \"modelVersion\": \"gemini-3.8-flash\",\n \"responseId\": \"WK2mauioB9nbxs0PnK3_8AM\"\n}\n"+ headers:+ alt-svc:+ - h3=":443"; ma=2592000,h3-29=":443"; ma=2592000+ content-type:+ - application/json; charset=UTF-8+ date:+ - Sun, 13 Sep 2026 14:04:11 GMT+ server:+ - scaffolding on HTTPServer2+ server-timing:+ - gfet4t7; dur=3461+ transfer-encoding:+ - chunked+ vary:+ - Origin+ - X-Origin+ - Referer+ x-content-type-options:+ - X-CONTENT-TYPE-XXX+ x-frame-options:+ - X-FRAME-OPTIONS-XXX+ x-gemini-service-tier:+ - standard+ x-xss-protection:+ - X-XSS-PROTECTION-XXX+ status:+ code: 200+ message: OK+version: 1diff --git a/lib/crewai/tests/llms/google/test_google.py b/lib/crewai/tests/llms/google/test_google.pyindex 17b0b2700..31fe5f8fa 100644--- a/lib/crewai/tests/llms/google/test_google.py+++ b/lib/crewai/tests/llms/google/test_google.py@@ -20,27 +20,44 @@ def mock_google_api_key():yield-def test_gemini_completion_is_used_when_google_provider():+ "model, expected_model",+ [+ ("google/gemini-2.0-flash-001", "gemini-2.0-flash-001"),+ ("google/gemini-3.8-flash", "gemini-3.8-flash"),+ ],+)+def test_gemini_completion_is_used_when_google_provider(model, expected_model):"""- Test that GeminiCompletion from completion.py is used when LLM uses provider 'google'+ Test that GeminiCompletion is used when LLM uses provider 'google'"""- llm = LLM(model="google/gemini-2.0-flash-001")+ llm = LLM(model=model)assert llm.__class__.__name__ == "GeminiCompletion"assert llm.provider == "gemini"- assert llm.model == "gemini-2.0-flash-001"+ assert llm.model == expected_model+-def test_gemini_completion_is_used_when_gemini_provider():+ "model, expected_model",+ [+ ("gemini/gemini-2.0-flash-001", "gemini-2.0-flash-001"),+ ("gemini/gemini-3.8-flash", "gemini-3.8-flash"),+ ],+)+def test_gemini_completion_is_used_when_gemini_provider(model, expected_model):"""Test that GeminiCompletion is used when provider is 'gemini'"""- llm = LLM(model="gemini/gemini-2.0-flash-001")-from crewai.llms.providers.gemini.completion import GeminiCompletion++ llm = LLM(model=model)+assert isinstance(llm, GeminiCompletion)assert llm.provider == "gemini"- assert llm.model == "gemini-2.0-flash-001"+ assert llm.model == expected_model+def test_gemini_completion_module_is_imported():"""@@ -330,7 +347,7 @@ def test_gemini_completion_with_tools():def test_gemini_raises_error_when_model_not_supported():- """Test that GeminiCompletion raises ValueError when model not supported"""+ """Test that GeminiCompletion raises an API error for an unsupported model."""with patch('crewai.llms.providers.gemini.completion.genai') as mock_genai:mock_client = MagicMock()@@ -342,7 +359,7 @@ def test_gemini_raises_error_when_model_not_supported():mock_response.body_segments = [{'error': {'code': 404,- 'message': 'models/model-doesnt-exist is not found for API version v1beta, or is not supported for generateContent.',+ 'message': 'models/gemini-model-doesnt-exist is not found for API version v1beta, or is not supported for generateContent.','status': 'NOT_FOUND'}}]@@ -350,11 +367,13 @@ def test_gemini_raises_error_when_model_not_supported():mock_client.models.generate_content.side_effect = ClientError(404, mock_response)- llm = LLM(model="google/model-doesnt-exist")+ llm = LLM(model="google/gemini-model-doesnt-exist")- with pytest.raises(Exception): # Should raise some error for unsupported model+ with pytest.raises(ClientError, match="404"):llm.call("Hello")+ mock_client.models.generate_content.assert_called_once()+def test_gemini_vertex_ai_setup():"""@@ -440,6 +459,8 @@ def test_gemini_model_detection():"""# Test Gemini model naming patterns that actually work with provider detectiongemini_test_cases = [+ "gemini/gemini-3.8-flash",+ "google/gemini-3.8-flash","google/gemini-2.0-flash-001","gemini/gemini-2.0-flash-001","google/gemini-1.5-pro",@@ -469,6 +490,11 @@ def test_gemini_context_window_size():context_size_2_0 = llm_2_0.get_context_window_size()assert context_size_2_0 > 500000+ # Test Gemini 3.8 Flash+ llm_3_8 = LLM(model="google/gemini-3.8-flash")+ context_size_3_8 = llm_3_8.get_context_window_size()+ assert context_size_3_8 == 891289+# Test Gemini 1.5 Prollm_1_5 = LLM(model="google/gemini-1.5-pro")context_size_1_5 = llm_1_5.get_context_window_size()diff --git a/lib/crewai/tests/test_llm.py b/lib/crewai/tests/test_llm.pyindex ec15e8a3c..dde38fb9d 100644--- a/lib/crewai/tests/test_llm.py+++ b/lib/crewai/tests/test_llm.py@@ -254,6 +254,7 @@ def test_validate_call_params_no_response_format():@pytest.mark.parametrize("model",[+ "gemini/gemini-3.8-flash","gemini/gemini-3-pro-preview","gemini/gemini-2.0-flash-thinking-exp-01-21","gemini/gemini-2.0-flash-001",