🚀 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)**이 즉시 나타납니다:

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

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

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)

%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로 저장하고 출력해줘.