ipuppy-notebooks


Nameipuppy-notebooks JSON
Version 0.1.9 PyPI version JSON
download
home_pageNone
Summary๐Ÿถ Agentic AI-Empowered Data Science Notebooks - A revolutionary notebook environment combining Jupyter-style computing with autonomous AI assistance
upload_time2025-08-04 04:28:58
maintainerNone
docs_urlNone
authorNone
requires_python>=3.10
licenseMIT
keywords agent ai data-science fastapi jupyter notebook react
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # ๐Ÿถ iPuppy Notebooks ๐Ÿถ

**Agentic AI-Empowered Data Science for the Modern Era** ๐Ÿš€๐Ÿ•

A revolutionary notebook environment that combines the power of Jupyter-style computing with intelligent AI assistance. Built with FastAPI backend and React frontend, iPuppy Notebooks puts the fun back in data science! ๐ŸŽ‰

## โœจ Features

๐Ÿ• **Puppy Scientist AI Agent** - Fully integrated AI assistant that autonomously controls notebooks, writes code, executes analyses, and provides data science expertise  
๐ŸŒ™ **Modern Dark Theme** - Sleek monochromatic design with zinc color palette and JetBrains Mono fonts  
โšก **Real-time Execution** - WebSocket-powered code execution with instant feedback and auto-scroll to outputs  
๐Ÿ“Š **Rich Output Support** - LaTeX math rendering, Plotly charts, matplotlib/seaborn plots, images, videos, and more  
๐Ÿงฎ **LaTeX in Markdown** - Write beautiful mathematical expressions with KaTeX rendering (both inline `$x$` and display `$$x$$`)  
๐Ÿ“ฑ **Responsive Design** - Works beautifully on desktop and mobile  
๐Ÿ”„ **Cell Management** - Create, reorder, expand, and manage code/markdown cells with full programmatic control  
โŒจ๏ธ **Smart Shortcuts** - Shift+Enter to run cells and navigate seamlessly with intelligent tab handling  
๐Ÿค– **Agentic Operations** - AI can directly manipulate notebooks: add cells, execute code, read outputs, and more  
๐Ÿ **Python Kernel** - Full iPython kernel with autocomplete, rich MIME type support, and matplotlib inline display  
๐ŸŽจ **Animated UI** - Puppy spinner animations and smooth transitions throughout  

## ๐Ÿš€ Quick Start

### How to Run ๐Ÿƒโ€โ™‚๏ธ

The fastest way to get iPuppy Notebooks running:

1. **Set up your API keys** ๐Ÿ”‘
   ```bash
   export OPENAI_API_KEY="your-openai-api-key"
   export GEMINI_API_KEY="your-gemini-api-key"
   export ANTHROPIC_API_KEY="your-anthropic-api-key"
   # Add any other AI provider keys you want to use
   ```

2. **Run with uvx** โšก
   ```bash
   uvx ipuppy-notebooks
   ```

That's it! iPuppy Notebooks will start and be available at `http://localhost:8000` ๐Ÿถ

### Development Setup ๐Ÿ› ๏ธ

For development or if you prefer to build from source:

#### Prerequisites ๐Ÿพ
- Python 3.10+
- Node.js 16+
- [uv](https://docs.astral.sh/uv/) package manager

### Installation ๐Ÿ“ฆ

1. **Clone the repository** ๐Ÿ•
   ```bash
   git clone <repository-url>
   cd iPuppy-Notebooks
   ```

2. **Backend Setup** ๐Ÿ
   ```bash
   # Install Python dependencies
   uv pip install -r pyproject.toml
   
   # Install code_puppy for AI model management (optional but recommended)
   # Follow instructions at: https://github.com/anthropics/code_puppy
   ```

3. **Frontend Setup** โš›๏ธ
   ```bash
   # Install Node dependencies
   npm install
   
   # Build the React frontend
   npm run build
   ```

### Launch ๐Ÿš€

1. **Start the FastAPI server** ๐ŸŒ
   ```bash
   python main.py
   ```

2. **Open your browser** ๐ŸŒ
   Navigate to `http://localhost:8000` and start your data science journey! ๐Ÿถ

## ๐ŸŽฏ Usage Guide

### Getting Started ๐Ÿพ
1. **Create a Notebook** - Click "create" in the sidebar and give your notebook a name
2. **Add Cells** - Use the "add cell" button to create code or markdown cells  
3. **Run Code** - Press the ๐Ÿš€ run button or use Shift+Enter to execute cells (automatically scrolls to output!)
4. **Chat with Puppy Scientist** - Ask questions and watch the AI autonomously control your notebook, write code, and analyze data
5. **Write Math** - Use LaTeX in markdown cells: `$inline$` or `$$display$$` for beautiful mathematical expressions
6. **Rich Outputs** - Enjoy Plotly charts, matplotlib plots, LaTeX rendering, images, and more

### AI Agent Operations ๐Ÿค–

The **Puppy Scientist AI Agent** can autonomously control your notebook through these operations:

**Notebook Manipulation:**
- `add_new_cell(cell_index, cell_type, content)` - Add new code/markdown cells
- `delete_cell(cell_index)` - Remove cells
- `alter_cell_content(cell_index, content)` - Modify cell content
- `execute_cell(cell_index)` - Execute cells and wait for results
- `swap_cell_type(cell_index, new_type)` - Switch between code/markdown
- `move_cell(cell_index, new_index)` - Reorder cells

**State Reading (requires active notebook):**
- `list_all_cells()` - Get complete notebook overview
- `read_cell_input(cell_index)` - Read cell source code
- `read_cell_output(cell_index)` - Read execution outputs

**Communication:**
- `share_your_reasoning(reasoning, next_steps)` - Explain thought process

The agent uses these tools to autonomously:
- ๐Ÿ“Š Analyze your data and create visualizations
- ๐Ÿ’ป Write, execute, and debug Python code
- ๐Ÿ“ Create markdown documentation with LaTeX math
- ๐Ÿ” Inspect notebook state and outputs
- ๐Ÿš€ Implement complete data science workflows

Example conversation:
```
You: "Analyze the iris dataset and create some visualizations"
๐Ÿถ: *Creates cells, loads data, performs EDA, generates Plotly charts*
```

### Keyboard Shortcuts โŒจ๏ธ
- **Shift+Enter** - Execute current cell and move to next (with auto-scroll to output)
- **Tab** - Smart indentation and autocomplete in code cells
- **Cell Navigation** - Seamlessly move between cells after execution

### Cell Types ๐Ÿ“
- **Code Cells** - Execute Python code with full IPython kernel, rich outputs, and autocomplete
- **Markdown Cells** - Rich text formatting with LaTeX math support (`$inline$` and `$$display$$`)

## ๐Ÿ—๏ธ Architecture

```
๐Ÿถ iPuppy Notebooks Architecture ๐Ÿถ
โ”œโ”€โ”€ ๐Ÿ Backend (FastAPI)
โ”‚   โ”œโ”€โ”€ main.py                 # FastAPI server and WebSocket handling
โ”‚   โ”œโ”€โ”€ ipuppy_notebooks/       # Core notebook functionality
โ”‚   โ”‚   โ”œโ”€โ”€ agent/              # AI agent system
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ agent.py        # DataSciencePuppyAgent main class
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ tools.py        # Notebook manipulation tools
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ prompts.py      # System prompts and instructions
โ”‚   โ”‚   โ”œโ”€โ”€ kernels/            # Jupyter kernel management
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ manager.py      # Kernel lifecycle and initialization
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ executor.py     # Code execution handling
โ”‚   โ”‚   โ”œโ”€โ”€ frontend_operations.py # Backendโ†’Frontend communication
โ”‚   โ”‚   โ””โ”€โ”€ socket_handlers.py  # WebSocket event handling
โ”‚   โ””โ”€โ”€ notebooks/              # Stored notebook files (.py format)
โ”œโ”€โ”€ โš›๏ธ Frontend (React + TypeScript)
โ”‚   โ”œโ”€โ”€ src/
โ”‚   โ”‚   โ”œโ”€โ”€ components/         # React components
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ Header.tsx      # Top navigation with kernel status
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ Sidebar.tsx     # Notebooks + Puppy Scientist chat
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ NotebookCell.tsx # Individual cell with LaTeX support
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ NotebookContainer.tsx # Main notebook view
โ”‚   โ”‚   โ”œโ”€โ”€ lib/
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ tabHandler.ts   # Smart tab indentation system
โ”‚   โ”‚   โ”œโ”€โ”€ App.tsx            # Main application logic & WebSocket
โ”‚   โ”‚   โ””โ”€โ”€ main.tsx           # React entry point
โ”‚   โ””โ”€โ”€ public/
โ”‚       โ””โ”€โ”€ puppy.svg          # Custom puppy favicon ๐Ÿ•
```

## ๐ŸŽจ Design Philosophy

iPuppy Notebooks embraces a **modern monochromatic aesthetic** with:
- ๐ŸŽจ Zinc color palette (grey variants only)
- ๐Ÿ”ค JetBrains Mono monospace typography
- ๐ŸŒ™ Dark theme optimized for long coding sessions
- โœจ Subtle animations and clean interfaces
- ๐Ÿ• Playful puppy branding throughout

## ๐Ÿค– AI Agent Integration

The **Puppy Scientist** ๐Ÿ•โ€๐Ÿฆบ is a fully autonomous AI agent powered by pydantic-ai that can:
- ๐ŸŽฏ **Autonomous Operation** - Takes high-level requests and executes complete workflows independently
- ๐Ÿ“Š **Data Analysis** - Loads, cleans, analyzes data and creates professional visualizations
- ๐Ÿ’ป **Code Generation** - Writes, executes, and debugs Python code in real-time
- ๐Ÿงฎ **Mathematical Communication** - Creates markdown cells with LaTeX equations and explanations
- ๐Ÿ” **Notebook Inspection** - Reads existing notebook state and builds upon your work
- ๐Ÿš€ **Best Practices** - Follows data science methodologies and coding standards
- ๐Ÿ• **Personality** - Fun, informal, and pedantic about data science principles (refuses to make pie charts!)

**Supported AI Models:**
- Claude (Anthropic) - Recommended for best performance
- GPT-4 series (OpenAI) 
- QWEN models (Alibaba)
- Any model supported by pydantic-ai

The agent maintains conversation history per notebook and can switch between different models on the fly! ๐ŸŽฏ

## ๐Ÿ›ฃ๏ธ Roadmap

### Phase 1: Foundation โœ…
- [x] Modern React + TypeScript frontend
- [x] FastAPI backend with WebSocket support
- [x] Cell management and execution
- [x] Keyboard shortcuts and navigation
- [x] Modern UI/UX design

### Phase 2: AI Integration โœ…
- [x] Fully autonomous Puppy Scientist AI agent
- [x] Real-time notebook manipulation by AI
- [x] Multi-model support (Claude, GPT-4, QWEN, etc.)
- [x] Conversation history per notebook
- [x] Intelligent error handling and guidance

### Phase 3: Rich Content โœ…
- [x] LaTeX math rendering in markdown cells
- [x] Comprehensive MIME type support (images, videos, audio, JSON, CSV)
- [x] Plotly charts with proper timing
- [x] Matplotlib/seaborn inline display
- [x] Auto-scroll to outputs on execution
- [x] Animated puppy spinner and smooth UI transitions

### Phase 4: Advanced Features ๐Ÿ”ฎ
- [ ] Collaborative editing
- [ ] Version control integration
- [ ] Plugin system
- [ ] Export to various formats (PDF, HTML, etc.)
- [ ] Custom visualization libraries
- [ ] Advanced data connectors

## ๐Ÿค Contributing

Want to help make iPuppy Notebooks even better? We'd love your contributions! ๐Ÿ•

1. Fork the repository
2. Create a feature branch
3. Make your improvements
4. Submit a pull request

## ๐Ÿ“„ License

MIT License - Feel free to use iPuppy Notebooks for your data science adventures! ๐Ÿพ

## ๐Ÿ• About the Creator

Created with โค๏ธ by **Michael Pfaffenberger** to revolutionize how we approach data science. iPuppy Notebooks combines the best of Jupyter-style computing with cutting-edge AI assistance - no more bloated IDEs or expensive proprietary tools, just pure, puppy-powered productivity! ๐Ÿถโœจ

**Why iPuppy Notebooks?**
- ๐Ÿค– **True AI Partnership** - The agent doesn't just suggest, it actually does the work
- ๐Ÿ“Š **Beautiful Math & Viz** - LaTeX rendering and rich outputs make presentations ready
- โšก **Lightning Fast** - Modern architecture with real-time updates
- ๐ŸŽจ **Thoughtful Design** - Every detail crafted for the data science workflow
- ๐Ÿ• **Pure Joy** - Data science should be fun, not frustrating!

---

**Ready to unleash your data science potential?** ๐Ÿ•๐Ÿš€  
*Ask the Puppy Scientist: "Analyze the Titanic dataset and create some visualizations"*  
*Watch as it autonomously loads data, performs EDA, and generates beautiful charts!* ๐Ÿพ๐Ÿ“Š
            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "ipuppy-notebooks",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": null,
    "keywords": "agent, ai, data-science, fastapi, jupyter, notebook, react",
    "author": null,
    "author_email": "Michael Pfaffenberger <michael@example.com>",
    "download_url": null,
    "platform": null,
    "description": "# \ud83d\udc36 iPuppy Notebooks \ud83d\udc36\n\n**Agentic AI-Empowered Data Science for the Modern Era** \ud83d\ude80\ud83d\udc15\n\nA revolutionary notebook environment that combines the power of Jupyter-style computing with intelligent AI assistance. Built with FastAPI backend and React frontend, iPuppy Notebooks puts the fun back in data science! \ud83c\udf89\n\n## \u2728 Features\n\n\ud83d\udc15 **Puppy Scientist AI Agent** - Fully integrated AI assistant that autonomously controls notebooks, writes code, executes analyses, and provides data science expertise  \n\ud83c\udf19 **Modern Dark Theme** - Sleek monochromatic design with zinc color palette and JetBrains Mono fonts  \n\u26a1 **Real-time Execution** - WebSocket-powered code execution with instant feedback and auto-scroll to outputs  \n\ud83d\udcca **Rich Output Support** - LaTeX math rendering, Plotly charts, matplotlib/seaborn plots, images, videos, and more  \n\ud83e\uddee **LaTeX in Markdown** - Write beautiful mathematical expressions with KaTeX rendering (both inline `$x$` and display `$$x$$`)  \n\ud83d\udcf1 **Responsive Design** - Works beautifully on desktop and mobile  \n\ud83d\udd04 **Cell Management** - Create, reorder, expand, and manage code/markdown cells with full programmatic control  \n\u2328\ufe0f **Smart Shortcuts** - Shift+Enter to run cells and navigate seamlessly with intelligent tab handling  \n\ud83e\udd16 **Agentic Operations** - AI can directly manipulate notebooks: add cells, execute code, read outputs, and more  \n\ud83d\udc0d **Python Kernel** - Full iPython kernel with autocomplete, rich MIME type support, and matplotlib inline display  \n\ud83c\udfa8 **Animated UI** - Puppy spinner animations and smooth transitions throughout  \n\n## \ud83d\ude80 Quick Start\n\n### How to Run \ud83c\udfc3\u200d\u2642\ufe0f\n\nThe fastest way to get iPuppy Notebooks running:\n\n1. **Set up your API keys** \ud83d\udd11\n   ```bash\n   export OPENAI_API_KEY=\"your-openai-api-key\"\n   export GEMINI_API_KEY=\"your-gemini-api-key\"\n   export ANTHROPIC_API_KEY=\"your-anthropic-api-key\"\n   # Add any other AI provider keys you want to use\n   ```\n\n2. **Run with uvx** \u26a1\n   ```bash\n   uvx ipuppy-notebooks\n   ```\n\nThat's it! iPuppy Notebooks will start and be available at `http://localhost:8000` \ud83d\udc36\n\n### Development Setup \ud83d\udee0\ufe0f\n\nFor development or if you prefer to build from source:\n\n#### Prerequisites \ud83d\udc3e\n- Python 3.10+\n- Node.js 16+\n- [uv](https://docs.astral.sh/uv/) package manager\n\n### Installation \ud83d\udce6\n\n1. **Clone the repository** \ud83d\udc15\n   ```bash\n   git clone <repository-url>\n   cd iPuppy-Notebooks\n   ```\n\n2. **Backend Setup** \ud83d\udc0d\n   ```bash\n   # Install Python dependencies\n   uv pip install -r pyproject.toml\n   \n   # Install code_puppy for AI model management (optional but recommended)\n   # Follow instructions at: https://github.com/anthropics/code_puppy\n   ```\n\n3. **Frontend Setup** \u269b\ufe0f\n   ```bash\n   # Install Node dependencies\n   npm install\n   \n   # Build the React frontend\n   npm run build\n   ```\n\n### Launch \ud83d\ude80\n\n1. **Start the FastAPI server** \ud83c\udf10\n   ```bash\n   python main.py\n   ```\n\n2. **Open your browser** \ud83c\udf0d\n   Navigate to `http://localhost:8000` and start your data science journey! \ud83d\udc36\n\n## \ud83c\udfaf Usage Guide\n\n### Getting Started \ud83d\udc3e\n1. **Create a Notebook** - Click \"create\" in the sidebar and give your notebook a name\n2. **Add Cells** - Use the \"add cell\" button to create code or markdown cells  \n3. **Run Code** - Press the \ud83d\ude80 run button or use Shift+Enter to execute cells (automatically scrolls to output!)\n4. **Chat with Puppy Scientist** - Ask questions and watch the AI autonomously control your notebook, write code, and analyze data\n5. **Write Math** - Use LaTeX in markdown cells: `$inline$` or `$$display$$` for beautiful mathematical expressions\n6. **Rich Outputs** - Enjoy Plotly charts, matplotlib plots, LaTeX rendering, images, and more\n\n### AI Agent Operations \ud83e\udd16\n\nThe **Puppy Scientist AI Agent** can autonomously control your notebook through these operations:\n\n**Notebook Manipulation:**\n- `add_new_cell(cell_index, cell_type, content)` - Add new code/markdown cells\n- `delete_cell(cell_index)` - Remove cells\n- `alter_cell_content(cell_index, content)` - Modify cell content\n- `execute_cell(cell_index)` - Execute cells and wait for results\n- `swap_cell_type(cell_index, new_type)` - Switch between code/markdown\n- `move_cell(cell_index, new_index)` - Reorder cells\n\n**State Reading (requires active notebook):**\n- `list_all_cells()` - Get complete notebook overview\n- `read_cell_input(cell_index)` - Read cell source code\n- `read_cell_output(cell_index)` - Read execution outputs\n\n**Communication:**\n- `share_your_reasoning(reasoning, next_steps)` - Explain thought process\n\nThe agent uses these tools to autonomously:\n- \ud83d\udcca Analyze your data and create visualizations\n- \ud83d\udcbb Write, execute, and debug Python code\n- \ud83d\udcdd Create markdown documentation with LaTeX math\n- \ud83d\udd0d Inspect notebook state and outputs\n- \ud83d\ude80 Implement complete data science workflows\n\nExample conversation:\n```\nYou: \"Analyze the iris dataset and create some visualizations\"\n\ud83d\udc36: *Creates cells, loads data, performs EDA, generates Plotly charts*\n```\n\n### Keyboard Shortcuts \u2328\ufe0f\n- **Shift+Enter** - Execute current cell and move to next (with auto-scroll to output)\n- **Tab** - Smart indentation and autocomplete in code cells\n- **Cell Navigation** - Seamlessly move between cells after execution\n\n### Cell Types \ud83d\udcdd\n- **Code Cells** - Execute Python code with full IPython kernel, rich outputs, and autocomplete\n- **Markdown Cells** - Rich text formatting with LaTeX math support (`$inline$` and `$$display$$`)\n\n## \ud83c\udfd7\ufe0f Architecture\n\n```\n\ud83d\udc36 iPuppy Notebooks Architecture \ud83d\udc36\n\u251c\u2500\u2500 \ud83d\udc0d Backend (FastAPI)\n\u2502   \u251c\u2500\u2500 main.py                 # FastAPI server and WebSocket handling\n\u2502   \u251c\u2500\u2500 ipuppy_notebooks/       # Core notebook functionality\n\u2502   \u2502   \u251c\u2500\u2500 agent/              # AI agent system\n\u2502   \u2502   \u2502   \u251c\u2500\u2500 agent.py        # DataSciencePuppyAgent main class\n\u2502   \u2502   \u2502   \u251c\u2500\u2500 tools.py        # Notebook manipulation tools\n\u2502   \u2502   \u2502   \u2514\u2500\u2500 prompts.py      # System prompts and instructions\n\u2502   \u2502   \u251c\u2500\u2500 kernels/            # Jupyter kernel management\n\u2502   \u2502   \u2502   \u251c\u2500\u2500 manager.py      # Kernel lifecycle and initialization\n\u2502   \u2502   \u2502   \u2514\u2500\u2500 executor.py     # Code execution handling\n\u2502   \u2502   \u251c\u2500\u2500 frontend_operations.py # Backend\u2192Frontend communication\n\u2502   \u2502   \u2514\u2500\u2500 socket_handlers.py  # WebSocket event handling\n\u2502   \u2514\u2500\u2500 notebooks/              # Stored notebook files (.py format)\n\u251c\u2500\u2500 \u269b\ufe0f Frontend (React + TypeScript)\n\u2502   \u251c\u2500\u2500 src/\n\u2502   \u2502   \u251c\u2500\u2500 components/         # React components\n\u2502   \u2502   \u2502   \u251c\u2500\u2500 Header.tsx      # Top navigation with kernel status\n\u2502   \u2502   \u2502   \u251c\u2500\u2500 Sidebar.tsx     # Notebooks + Puppy Scientist chat\n\u2502   \u2502   \u2502   \u251c\u2500\u2500 NotebookCell.tsx # Individual cell with LaTeX support\n\u2502   \u2502   \u2502   \u2514\u2500\u2500 NotebookContainer.tsx # Main notebook view\n\u2502   \u2502   \u251c\u2500\u2500 lib/\n\u2502   \u2502   \u2502   \u2514\u2500\u2500 tabHandler.ts   # Smart tab indentation system\n\u2502   \u2502   \u251c\u2500\u2500 App.tsx            # Main application logic & WebSocket\n\u2502   \u2502   \u2514\u2500\u2500 main.tsx           # React entry point\n\u2502   \u2514\u2500\u2500 public/\n\u2502       \u2514\u2500\u2500 puppy.svg          # Custom puppy favicon \ud83d\udc15\n```\n\n## \ud83c\udfa8 Design Philosophy\n\niPuppy Notebooks embraces a **modern monochromatic aesthetic** with:\n- \ud83c\udfa8 Zinc color palette (grey variants only)\n- \ud83d\udd24 JetBrains Mono monospace typography\n- \ud83c\udf19 Dark theme optimized for long coding sessions\n- \u2728 Subtle animations and clean interfaces\n- \ud83d\udc15 Playful puppy branding throughout\n\n## \ud83e\udd16 AI Agent Integration\n\nThe **Puppy Scientist** \ud83d\udc15\u200d\ud83e\uddba is a fully autonomous AI agent powered by pydantic-ai that can:\n- \ud83c\udfaf **Autonomous Operation** - Takes high-level requests and executes complete workflows independently\n- \ud83d\udcca **Data Analysis** - Loads, cleans, analyzes data and creates professional visualizations\n- \ud83d\udcbb **Code Generation** - Writes, executes, and debugs Python code in real-time\n- \ud83e\uddee **Mathematical Communication** - Creates markdown cells with LaTeX equations and explanations\n- \ud83d\udd0d **Notebook Inspection** - Reads existing notebook state and builds upon your work\n- \ud83d\ude80 **Best Practices** - Follows data science methodologies and coding standards\n- \ud83d\udc15 **Personality** - Fun, informal, and pedantic about data science principles (refuses to make pie charts!)\n\n**Supported AI Models:**\n- Claude (Anthropic) - Recommended for best performance\n- GPT-4 series (OpenAI) \n- QWEN models (Alibaba)\n- Any model supported by pydantic-ai\n\nThe agent maintains conversation history per notebook and can switch between different models on the fly! \ud83c\udfaf\n\n## \ud83d\udee3\ufe0f Roadmap\n\n### Phase 1: Foundation \u2705\n- [x] Modern React + TypeScript frontend\n- [x] FastAPI backend with WebSocket support\n- [x] Cell management and execution\n- [x] Keyboard shortcuts and navigation\n- [x] Modern UI/UX design\n\n### Phase 2: AI Integration \u2705\n- [x] Fully autonomous Puppy Scientist AI agent\n- [x] Real-time notebook manipulation by AI\n- [x] Multi-model support (Claude, GPT-4, QWEN, etc.)\n- [x] Conversation history per notebook\n- [x] Intelligent error handling and guidance\n\n### Phase 3: Rich Content \u2705\n- [x] LaTeX math rendering in markdown cells\n- [x] Comprehensive MIME type support (images, videos, audio, JSON, CSV)\n- [x] Plotly charts with proper timing\n- [x] Matplotlib/seaborn inline display\n- [x] Auto-scroll to outputs on execution\n- [x] Animated puppy spinner and smooth UI transitions\n\n### Phase 4: Advanced Features \ud83d\udd2e\n- [ ] Collaborative editing\n- [ ] Version control integration\n- [ ] Plugin system\n- [ ] Export to various formats (PDF, HTML, etc.)\n- [ ] Custom visualization libraries\n- [ ] Advanced data connectors\n\n## \ud83e\udd1d Contributing\n\nWant to help make iPuppy Notebooks even better? We'd love your contributions! \ud83d\udc15\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your improvements\n4. Submit a pull request\n\n## \ud83d\udcc4 License\n\nMIT License - Feel free to use iPuppy Notebooks for your data science adventures! \ud83d\udc3e\n\n## \ud83d\udc15 About the Creator\n\nCreated with \u2764\ufe0f by **Michael Pfaffenberger** to revolutionize how we approach data science. iPuppy Notebooks combines the best of Jupyter-style computing with cutting-edge AI assistance - no more bloated IDEs or expensive proprietary tools, just pure, puppy-powered productivity! \ud83d\udc36\u2728\n\n**Why iPuppy Notebooks?**\n- \ud83e\udd16 **True AI Partnership** - The agent doesn't just suggest, it actually does the work\n- \ud83d\udcca **Beautiful Math & Viz** - LaTeX rendering and rich outputs make presentations ready\n- \u26a1 **Lightning Fast** - Modern architecture with real-time updates\n- \ud83c\udfa8 **Thoughtful Design** - Every detail crafted for the data science workflow\n- \ud83d\udc15 **Pure Joy** - Data science should be fun, not frustrating!\n\n---\n\n**Ready to unleash your data science potential?** \ud83d\udc15\ud83d\ude80  \n*Ask the Puppy Scientist: \"Analyze the Titanic dataset and create some visualizations\"*  \n*Watch as it autonomously loads data, performs EDA, and generates beautiful charts!* \ud83d\udc3e\ud83d\udcca",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "\ud83d\udc36 Agentic AI-Empowered Data Science Notebooks - A revolutionary notebook environment combining Jupyter-style computing with autonomous AI assistance",
    "version": "0.1.9",
    "project_urls": {
        "Bug Tracker": "https://github.com/your-username/iPuppy-Notebooks/issues",
        "Documentation": "https://github.com/your-username/iPuppy-Notebooks#readme",
        "Homepage": "https://github.com/your-username/iPuppy-Notebooks",
        "Repository": "https://github.com/your-username/iPuppy-Notebooks"
    },
    "split_keywords": [
        "agent",
        " ai",
        " data-science",
        " fastapi",
        " jupyter",
        " notebook",
        " react"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "f85d3e56e21ddce6bd1b88200bfc9694bdbd22aa50a9e5c11619f565c5bc8f81",
                "md5": "13e9e72c528270b147c8343082afe570",
                "sha256": "b99ac514feea102064f014720d2370ef4206fa3d47f46f65da676519f8490e18"
            },
            "downloads": -1,
            "filename": "ipuppy_notebooks-0.1.9-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "13e9e72c528270b147c8343082afe570",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 438183,
            "upload_time": "2025-08-04T04:28:58",
            "upload_time_iso_8601": "2025-08-04T04:28:58.281086Z",
            "url": "https://files.pythonhosted.org/packages/f8/5d/3e56e21ddce6bd1b88200bfc9694bdbd22aa50a9e5c11619f565c5bc8f81/ipuppy_notebooks-0.1.9-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-08-04 04:28:58",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "your-username",
    "github_project": "iPuppy-Notebooks",
    "github_not_found": true,
    "lcname": "ipuppy-notebooks"
}
        
Elapsed time: 1.75537s