Alternative intro (#270)

Co-authored-by: Sydney Runkle <[email protected]>
Co-authored-by: Bradley <[email protected]>
Co-authored-by: Laura Summers <[email protected]>

Author: 4 people

README.md

@@ -23,16 +23,18 @@
 
 ---
 
-When I first found FastAPI, I got it immediately. I was excited to find something so innovative and ergonomic built on Pydantic.
+PydanticAI is a Python agent framework designed to make it less painful to build production grade applications with Generative AI.
 
-Virtually every Agent Framework and LLM library in Python uses Pydantic, but when we began to use LLMs in [Pydantic Logfire](https://pydantic.dev/logfire), I couldn't find anything that gave me the same feeling.
+FastAPI revolutionized web development by offering an innovative and ergonomic design, built on the foundation of [Pydantic](https://docs.pydantic.dev).
 
-PydanticAI is a Python Agent Framework designed to make it less painful to build production grade applications with Generative AI.
+Similarly, virtually every agent framework and LLM library in Python uses Pydantic, yet when we began to use LLMs in [Pydantic Logfire](https://pydantic.dev/logfire), we couldn't find anything that gave us the same feeling.
+
+We built PydanticAI with one simple aim: to bring that FastAPI feeling to GenAI app development.
 
 ## Why use PydanticAI
 
 * Built by the team behind Pydantic (the validation layer of the OpenAI SDK, the Anthropic SDK, LangChain, LlamaIndex, AutoGPT, Transformers, CrewAI, Instructor and many more)
-* Model-agnostic — currently OpenAI, Gemini, Anthropic, Groq, and Mistral are supported. And there is a simple interface to implement support for other models.
+* [Model-agnostic](https://ai.pydantic.dev/models/) — currently OpenAI, Anthropic, Gemini, Ollama, Groq, and Mistral are supported, and there is a simple interface to implement support for other models.
 * [Type-safe](https://ai.pydantic.dev/agents/#static-type-checking)
 * Control flow and agent composition is done with vanilla Python, allowing you to make use of the same Python development best practices you'd use in any other (non-AI) project
 * [Structured response](https://ai.pydantic.dev/results/#structured-result-validation) validation with Pydantic

docs/.partials/index-header.html

@@ -1,8 +1,8 @@
 <div class="text-center">
-  <img class="index-header" src="./img/pydantic-ai-dark.svg#only-dark" alt="PydanticAI">
+  <img class="index-header off-glb" src="./img/pydantic-ai-dark.svg#only-dark" alt="PydanticAI">
 </div>
 <div class="text-center">
-  <img class="index-header" src="./img/pydantic-ai-light.svg#only-light" alt="PydanticAI">
+  <img class="index-header off-glb" src="./img/pydantic-ai-light.svg#only-light" alt="PydanticAI">
 </div>
 <p class="text-center">
   <em>Agent Framework / shim to use Pydantic with LLMs</em>
@@ -21,6 +21,11 @@
     <img src="https://img.shields.io/pypi/pyversions/pydantic-ai.svg" alt="versions">
   </a>
   <a href="https://github.com/pydantic/pydantic-ai/blob/main/LICENSE">
-    <img src="https://img.shields.io/github/license/pydantic/pydantic-ai.svg?v" alt="license">
+    <img src="https://img.shields.io/github/license/pydantic/pydantic-ai.svg" alt="license">
   </a>
 </p>
+
+<p class="text-emphasis">
+  PydanticAI is a Python agent framework designed to make it less painful to
+  build production grade applications with Generative AI.
+</p>

docs/extra/tweaks.css

@@ -16,3 +16,9 @@ img.index-header {
   width: 70%;
   max-width: 500px;
 }
+
+.text-emphasis {
+  font-size: 1rem;
+  font-weight: 300;
+  font-style: italic;
+}

docs/index.md

@@ -2,11 +2,14 @@
 
 --8<-- "docs/.partials/index-header.html"
 
-When I first found FastAPI, I got it immediately. I was excited to find something so innovative and ergonomic built on Pydantic.
+PydanticAI is a Python Agent Framework designed to make it less painful to
+build production grade applications with Generative AI.
 
-Virtually every Agent Framework and LLM library in Python uses Pydantic, but when we began to use LLMs in [Pydantic Logfire](https://pydantic.dev/logfire), I couldn't find anything that gave me the same feeling.
+FastAPI revolutionized web development by offering an innovative and ergonomic design, built on the foundation of [Pydantic](https://docs.pydantic.dev).
 
-PydanticAI is a Python Agent Framework designed to make it less painful to build production grade applications with Generative AI.
+Similarly, virtually every agent framework and LLM library in Python uses Pydantic, yet when we began to use LLMs in [Pydantic Logfire](https://pydantic.dev/logfire), we couldn't find anything that gave us the same feeling.
+
+We built PydanticAI with one simple aim: to bring that FastAPI feeling to GenAI app development.
 
 ## Why use PydanticAI