revamp readme (#55)

* revamp readme

* correct link

* correct command

Author: eleonorecharles

README.md

@@ -13,62 +13,102 @@
 [![Github Actions Status](https://github.com/datalayer/jupyter-ai-agents/workflows/Build/badge.svg)](https://github.com/datalayer/jupyter-ai-agents/actions/workflows/build.yml)
 [![PyPI - Version](https://img.shields.io/pypi/v/jupyter-ai-agents)](https://pypi.org/project/jupyter-ai-agents)
 
-*The Jupyter AI Agents are equipped with tools like 'execute', 'insert_cell', and more, to transform your Jupyter Notebooks into an intelligent, interactive workspace!*
+🪐 ✨ AI Agents for JupyterLab with 🛠️ MCP tools - Chat interface for intelligent notebook interaction, code execution, and workspace management.
+
+## 💬 Chat Interface
+
+Experience seamless AI-powered assistance directly within JupyterLab through our intuitive chat interface:
 
 ![Jupyter AI Agents Chat 1](https://assets.datalayer.tech/jupyter-ai-agents/jupyter-ai-agents-chat-1.png)
 
-![Jupyter AI Agents Chat 1](https://assets.datalayer.tech/jupyter-ai-agents/jupyter-ai-agents-chat-2.png)
+The chat interface is built using [Pydantic AI](https://github.com/pydantic/pydantic-ai) for robust AI agent orchestration and [Vercel AI Elements](https://github.com/vercel/ai-elements) for the user interface components.
 
-![Jupyter AI Agents CLI](https://assets.datalayer.tech/jupyter-ai-agent/ai-agent-prompt-demo-terminal.gif)
+### MCP Server Integration
 
-Jupyter AI Agents empowers **AI** models to **interact** with and **modify Jupyter Notebooks**. The agent is equipped with tools such as adding code cells, inserting markdown cells, executing code, enabling it to modify the notebook comprehensively based on user instructions or by reacting to the Jupyter notebook events.
+By default, the [Jupyter MCP Server](https://github.com/datalayer/jupyter-mcp-server) is started as a Jupyter server extension, providing access to all Jupyter MCP server tools directly through the chat interface. This enables the AI agent to interact with notebooks, execute code, manage files, and perform various Jupyter operations seamlessly.
 
-This Agent is **innovative** as it is designed to **operate on the entire Notebook**, not just at the cell level, enabling more comprehensive and seamless modifications.
+![Jupyter AI Agents Chat 2](https://assets.datalayer.tech/jupyter-ai-agents/jupyter-ai-agents-chat-2.png)
 
-The Agent can also run separetely from the Jupyter server as the communication is achieved through RTC via the [Jupyter NbModel Client](https://github.com/datalayer/jupyter-nbmodel-client) and the [Jupyter Kernel Client](https://github.com/datalayer/jupyter-kernel-client).
+### Getting Started with Chat
 
-```
-Jupyter AI Agents <---> JupyterLab
-       |
-       | RTC (Real Time Collaboration)
-       |
-Jupyter Clients
-```
+Currently, we support **Anthropic Claude Sonnet 4.0** as the AI model. To get started:
+
+1. **Set up your environment:**
+   ```bash
+   export ANTHROPIC_API_KEY='your-api-key-here'
+   ```
+
+2. **Install Jupyter AI Agents:**
+   ```bash
+   pip install jupyter_ai_agents
+   pip uninstall -y pycrdt datalayer_pycrdt
+   pip install datalayer_pycrdt==0.12.17
+   ```
+
+3. **Launch JupyterLab with the required configuration:**
+   ```bash
+   jupyter lab
+   ```
+
+4. **Access the chat interface** through the right panel in JupyterLab.
+
+### What's Coming Next
+
+We're actively working on expanding the capabilities of Jupyter AI Agents:
+
+- 🚀 **More LLM Providers**: Integration with additional AI model providers
+- ⚙️ **MCP Configuration**: Enhanced MCP server configuration options
+- 🔧 **Extended Tool Access**: Chat access to tools from other MCP servers
+- 🛠️ **Enhanced Features**: And much more!
+
+Check out our [GitHub Issues](https://github.com/datalayer/jupyter-ai-agents/issues) to see what we're working on. **Contributions are welcome!**
+
+> **Note**: The documentation at https://jupyter-ai-agents.datalayer.tech will be updated soon to reflect the new chat features and capabilities.
 
-This library is documented on https://jupyter-ai-agents.datalayer.tech.
 
-## Install
+<details>
+<summary><strong>🖥️ CLI Usage</strong></summary>
 
-To install Jupyter AI Agents, run the following command.
+## CLI Usage
+
+You can also use Jupyter AI Agents through the command line interface for automated notebook operations.
+
+![Jupyter AI Agents CLI](https://assets.datalayer.tech/jupyter-ai-agent/ai-agent-prompt-demo-terminal.gif)
+
+
+### Basic Installation
+
+To install Jupyter AI Agents, run the following command:
 
 ```bash
 pip install jupyter_ai_agents
 pip uninstall -y pycrdt datalayer_pycrdt
 pip install datalayer_pycrdt==0.12.17
 ```
 
-Or clone this repository and install it from source.
+Or clone this repository and install it from source:
 
 ```bash
 git clone https://github.com/datalayer/jupyter-ai-agents
 cd jupyter-ai-agents
 pip install -e .
 ```
 
-The Jupyter AI Agents can directly interact with JupyterLab. The modifications made by the Jupyter AI Agents can be seen in real-time thanks to [Jupyter Real Time Collaboration](https://jupyterlab.readthedocs.io/en/stable/user/rtc.html). Make sure you have JupyterLab installed with the Collaboration extension.
+### JupyterLab Setup
+
+The Jupyter AI Agents can directly interact with JupyterLab. The modifications made by the Jupyter AI Agents can be seen in real-time thanks to [Jupyter Real Time Collaboration](https://jupyterlab.readthedocs.io/en/stable/user/rtc.html). Make sure you have JupyterLab installed with the Collaboration extension:
 
 ```bash
 pip install jupyterlab==4.4.1 jupyter-collaboration==4.0.2
 ```
 
-We ask you to take additional actions to overcome limitations and bugs of the pycrdt library. Ensure you create a new shell after running the following commands.
+We ask you to take additional actions to overcome limitations and bugs of the pycrdt library. Ensure you create a new shell after running the following commands:
 
 ```bash
 pip uninstall -y pycrdt datalayer_pycrdt
 pip install datalayer_pycrdt==0.12.17
 ```
-
-## Use from the CLI
+### Examples
 
 We put here a quick example for a Out-Kernel Stateless Agent via CLI helping your JupyterLab session.
 
@@ -124,21 +164,23 @@ jupyter-ai-agents explain-error \
 
 ![Jupyter AI Agents](https://assets.datalayer.tech/jupyter-ai-agent/ai-agent-explainerror-demo-terminal.gif)
 
-## Uninstall
 
-To uninstall the agent, execute.
+### About the Technology
 
-```bash
-pip uninstall jupyter_ai_agents
-```
+Jupyter AI Agents empowers **AI** models to **interact** with and **modify Jupyter Notebooks**. The agent is equipped with tools such as adding code cells, inserting markdown cells, executing code, enabling it to modify the notebook comprehensively based on user instructions or by reacting to the Jupyter notebook events.
 
-## Deploy in a Server
+This Agent is **innovative** as it is designed to **operate on the entire Notebook**, not just at the cell level, enabling more comprehensive and seamless modifications.
 
-You can start a Jupyter AI Agents server to be used in combination with the [Datalayer online services](https://datalayer.app).
+The Agent can also run separately from the Jupyter server as the communication is achieved through RTC via the [Jupyter NbModel Client](https://github.com/datalayer/jupyter-nbmodel-client) and the [Jupyter Kernel Client](https://github.com/datalayer/jupyter-kernel-client).
 
-```bash
-make server
 ```
+Jupyter AI Agents <---> JupyterLab
+       |
+       | RTC (Real Time Collaboration)
+       |
+Jupyter Clients
+```
+</details>
 
 ## Contributing