Pixeltable Cloud가 제한적 베타(Limited Beta)를 시작했습니다. 관심 있으시면 [email protected]으로 이메일을 보내주세요.
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/pixeltable/pixeltable/main/docs/release/_logo/pxt-dark.svg">
<img alt="Pixeltable" src="https://raw.githubusercontent.com/pixeltable/pixeltable/main/docs/release/_logo/pxt-light.svg" width="40%">
</picture>
멀티모달 데이터베이스, 오케스트레이션 및 서빙을 하나의 파일로 구축하는 백엔드 에이전트
빠른 시작(Quickstart) |
문서화(Documentation) |
CLI |
Cloud |
Discord
License
tests status
nightly status
stress-tests status
PyPI Package
Python
[Open in Cursor][cursor-prompt]
[Open in Claude][claude-prompt]
[Open in ChatGPT][chatgpt-prompt]
에이전트에 설치하기: Agent Skill ·
MCP server ·
Cursor plugin ·
Claude plugin ·
ChatGPT plugin
에이전트로 읽고 있나요? get-started.md에서 시작한 다음,
skill.md와
llms-full.txt를 확인하세요.
Pixeltable은 데이터베이스, 오케스트레이션, 그리고 서빙 레이어를 모두 제공합니다. 이미지, 비디오, 오디오, 문서가 테이블에 저장됩니다. 트랜스폼(transform)은 계산된 컬럼입니다. 인덱스는 선언이며, HTTP 라우트 역시 마찬가지입니다. 행을 삽입하면 그 아래의 모든 것이 실행됩니다. 오브젝트 스토리지, 벡터 데이터베이스, 오케스트레이터, 그리고 이들 사이에서 복사하는 엔드포인트 코드가 하나의 애플리케이션 파일로 통합됩니다. 이 파일이 바로 코딩 에이전트가 처리할 수 있는 형태입니다. 전체 애플리케이션을 한 번에 작성하며, 네 개의 시스템에 걸쳐 변경 사항을 검토하는 대신 단일 diff에서 변경 사항을 확인할 수 있습니다.
pip install 'pixeltable[serve]'
pxt init
pxt service example --out app.py
...
pxt schema update는 카탈로그 my_app과 그 테이블들을 생성하지만, HTTP를 시작하지는 않습니다.
pxt service update는 HTTP를 시작할 뿐, 테이블을 생성하지는 않습니다.
서비스의 OpenAPI 스키마로부터 TypeScript 타입을 생성하고 HTTP serving guide를 사용하여 Next.js 백엔드에서 호출할 수 있습니다.
pxt service example가 이 애플리케이션 파일을 작성합니다.
import pixeltable as pxt
import pixeltable.functions as pxtf
from pixeltable.serving import FastAPIRouter
...
같은 파일은 pxt.Image, pxt.Video, pxt.Audio, 또는 pxt.Document 컬럼을 포함할 수 있으며, 이들 중 하나에 대한 계산된 컬럼은 또 다른 할당이 됩니다:
미디어 파이프라인,
RAG. 포트는 지정되므로, 하드코딩하기보다는 읽어오는 것이 좋습니다:
URL=$(pxt service list --json | jq -r '.[0].endpoint')
curl -X POST "$URL/docs" \
-H 'Content-Type: application/json' \
...
같은 파일은 Pixeltable Cloud에서 실행됩니다. pxt login으로 로그인하세요. 만약 pxt org list에 조직(organization)이 표시되지 않으면, pxt org create NAME을 사용하여 하나를 만들고 그 데이터베이스인 main을 프로비저닝합니다. 이 항목을 프로젝트 파일에 추가하고, org 자리에 사용자의 조직 이름을 넣으세요:
[[pixeltable.database]]
name = 'pxt://org:main'
pxt db update pxt://org:main
pxt schema update app.py pxt://org:main
pxt service update app.py pxt://org:main
Cloud 가이드에서는 첫 번째 배포 단계를 API 키, 시크릿 및 변경 후 실행할 내용을 단계별로 다룹니다.
채팅 에이전트 또는 비디오 검색
uvx pixeltable-new는 스타터 키트의 앱을 복사합니다. 기본 복사본은 채팅 앱이며, pxt schema update에 마지막 인수로 agent를 전달하면 됩니다. --video는 비디오 검색을 복사하며, 이때 videointel을 전달합니다.
uvx pixeltable-new myapp
cd myapp
uv sync
...
지식 테이블에 삽입하는 것은 API 키가 필요하지 않습니다. /ask 경로는 ANTHROPIC_API_KEY가 필요합니다.
기존 FastAPI 앱의 라우트에 마운트하려면, app.include_router(...)를 사용합니다. HTTP 서빙을 참조하세요. 엔드포인트를 건너뛰려면, pxt schema update를 실행하고 Python에서 삽입한 다음, export_sql을 실행합니다. 셀프 호스팅 방법을 참고하세요.
코딩 에이전트
위 링크들은 Skill, 플러그인 및 MCP 설정 옵션을 제공합니다. Skill이 app.py를 작성하는 방법은 AI 코딩 에이전트를 참조하세요.
Pixeltable 플러그인은 Claude, Cursor 및 ChatGPT용 Skill을 패키징합니다. Docs MCP는 공개 문서를 검색하며, 이 사이트는 문서 검색 및 통합 목록을 위한 원격 HTTP Site MCP도 제공합니다. 호스팅 클라우드 MCP는 OAuth를 통해 로그인된 Cloud 조직을 읽습니다. 또한 데이터베이스를 시작 및 중지하고, 서비스를 재시작하며, 시크릿을 설정할 수 있습니다. 로컬 개발자 MCP는 카탈로그, 쿼리 및 REPL 도구와 함께 사용자의 장치에서 실행됩니다. 호스팅 클라우드 MCP는 배포하거나 삭제하지 않으므로, 이 용도로는 pxt CLI를 사용해야 합니다.
npx skills add pixeltable/pixeltable-skill
이 스킬은 app.py에 TableModel을 작성합니다. 만약 에이전트가 애플리케이션 코드에서 create_table을 작성하거나, 파일을 schema.py로 명명하거나, 삭제된 명령어인 pxt serve를 작성하면 설치된 스킬이 오래됩니다: npx skills add pixeltable/pixeltable-skill을 다시 실행하세요.
노트북과 테스트는 여전히 pxt.create_table()을 사용합니다. 앱은 app.py에 테이블을 넣고 pxt schema update로 생성합니다.
라이선스
Apache 2.0. 기여하기 · Discord
[cursor-prompt]: https://cursor.com/link/prompt?text=Pixeltable을 사용하여 멀티모달 AI 데이터 앱 구축하기.+https%3A%2F%2Fpixeltable.com%2Fget-started.md를 따르세요.
[claude-prompt]: https://claude.ai/new?q=Pixeltable을 사용하여 멀티모달 AI 데이터 앱 구축하기.+https%3A%2F%2Fpixeltable.com%2Fget-started.md를 따르세요.
[chatgpt-prompt]: https://chatgpt.com/?prompt=Pixeltable을 사용하여 멀티모달 AI 데이터 앱 구축하기.+https%3A%2F%2Fpixeltable.com%2Fget-started.md를 따르세요.