Metadata-Version: 2.5
Name: jupyter-omni-agent
Version: 0.2.0
Summary: Multi-provider AI Agent & Right-Side GUI Copilot Sidebar for Jupyter Notebook (OpenAI, Anthropic, Gemini, OpenRouter, Ollama, DeepSeek, Groq) that writes and executes Python code directly in your local kernel.
Project-URL: Homepage, https://github.com/cdsassj00/jupyter-omni-agent
Project-URL: Issues, https://github.com/cdsassj00/jupyter-omni-agent/issues
Author-email: Antigravity Lab <cdsassj00@gmail.com>
License: MIT
Keywords: ai-agent,anthropic,code-interpreter,gemini,gui,ipython,jupyter,ollama,openai,openrouter,sidebar
Classifier: Development Status :: 4 - Beta
Classifier: Framework :: IPython
Classifier: Framework :: Jupyter
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Requires-Dist: ipython>=8.0.0
Requires-Dist: ipywidgets>=8.0.0
Requires-Dist: requests>=2.28.0
Description-Content-Type: text/markdown

# 🚀 `jupyter-omni-agent` (v0.2.0 — 우측 GUI 사이드바 탑재!)

**로컬 Jupyter Notebook을 켠 상태에서 설치 후 실행하면 화면 오른쪽에 AI 코파일럿 GUI 사이드바가 즉시 부착되며, 다양한 AI 서비스 API 키(OpenAI, Anthropic Claude, Google Gemini, OpenRouter, DeepSeek, Groq, Upstage Solar) 및 로컬 Ollama를 연결하여 내 로컬 커널에서 파이썬 코드를 자동 작성·실행·자가수정(Self-Healing)해주는 올인원 AI 에이전트 라이브러리**입니다.

---

## 🖥️ NEW (v0.2.0): 주피터 노트북 우측 도킹형 GUI 사이드바!

주피터 노트북을 켠 상태에서 셀에 아래 두 줄만 실행하면 **화면 오른쪽에 슬라이드형 AI 코파일럿 GUI 사이드바**와 **인터랙티브 컨트롤 패널(`ipywidgets`)**이 즉시 나타납니다:

```python
!pip install -U jupyter-omni-agent
%load_ext jupyter_omni_agent
```

또는 파이썬 코드로 언제든 사이드바를 다시 열 수 있습니다:

```python
import jupyter_omni_agent as joa
joa.sidebar()   # 또는 매직 명령어: %ai_gui
```

### 우측 GUI 사이드바에서 할 수 있는 것
1. **드롭다운으로 AI 프로바이더 선택**: OpenRouter, OpenAI, Anthropic, Gemini, Ollama(로컬 무료), DeepSeek, Groq, Upstage
2. **API Key 입력창 & [🔑 키/모델 저장] 버튼**: 명령어를 외울 필요 없이 GUI 입력창에 키를 붙여넣고 버튼만 누르면 커널에 즉시 등록됩니다.
3. **실시간 로컬 변수 인스펙터 (`user_ns`)**: 현재 노트북 메모리에 올라와 있는 `DataFrame` 행/열 정보와 변수 목록을 사이드바에서 실시간으로 확인합니다.
4. **[🚀 코드 생성 & 로컬 실행] / [➕ 셀에 삽입]**: 프롬프트를 입력하고 버튼을 누르면 AI가 짠 파이썬 코드가 내 로컬 커널에서 즉시 실행(에러 시 자동 수정)되거나 새 코드 셀로 자동 삽입됩니다.

---

## ✨ 핵심 기능

1. **멀티 프로바이더 통합 지원 (Zero-SDK 경량 구조)**:
   - **상용 AI API**: OpenAI (`gpt-4o`, `o3-mini`), Anthropic (`claude-3-7-sonnet`), Google Gemini (`gemini-2.5-pro`, `gemini-2.5-flash`), DeepSeek, Groq, Upstage Solar
   - **OpenRouter 통합 키**: `openrouter` 설정 하나로 수백 개의 최신 모델(`anthropic/claude-3.7-sonnet`, `deepseek/deepseek-r1`, `meta-llama/llama-3.3-70b-instruct` 등) 즉시 호출
   - **로컬 Ollama 완벽 지원**: API 키 없이 `http://localhost:11434`의 로컬 LLM(`qwen2.5-coder`, `llama3.3` 등) 연결
2. **내 로컬 Jupyter 커널 변수 자동 인식 & 직접 실행**:
   - 현재 노트북 메모리에 떠 있는 `pandas.DataFrame`의 행/열/컬럼명과 `numpy` 배열, 변수들을 자동으로 스캔해 프롬프트 컨텍스트에 주입합니다.
   - AI가 생성한 파이썬 코드를 내 로컬 `user_ns` 네임스페이스에서 즉시 실행하여 새로운 변수나 차트를 바로 생성합니다.
3. **자가 수정 (Self-Healing Execution Loop)**:
   - 실행 중 에러(Traceback)가 발생하면 AI가 자동으로 에러 로그를 읽고 수정된 코드를 재실행합니다.

---

## 💻 Jupyter Notebook 매직 명령어 사용법 (`%ai_gui`, `%%ai`)

```python
%load_ext jupyter_omni_agent

# 1. 우측 GUI 사이드바 열기 (로드 시 자동으로 열림)
%ai_gui

# 2. 코드로 API 키 등록하고 싶을 때
%ai_key openrouter sk-or-v1-xxxxxxxxxxxxxxxxxxxx

# 3. 사용할 프로바이더 & 모델 변경
%ai_config openrouter anthropic/claude-3.7-sonnet
%ai_config ollama qwen2.5-coder:7b

# 4. 셀에서 자연어로 로컬 파이썬 코드 생성 & 즉시 실행 (%%ai)
%%ai
현재 메모리에 있는 df 데이터프레임의 결측치를 평균값으로 채우고,
카테고리별 매출 합계를 구해서 파생변수 summary_df로 저장하고 출력해줘.
```
