๐ธ๏ธ ์ PySpur์ธ๊ฐ?
March 3, 2025 ยท View on GitHub

PySpur์ ํ์ด์ฌ ๊ธฐ๋ฐ์ AI ์์ด์ ํธ ๋น๋์ ๋๋ค. AI ์์ง๋์ด๋ค์ ์ด๋ฅผ ์ฌ์ฉํด ์์ด์ ํธ๋ฅผ ๊ตฌ์ถํ๊ณ , ๋จ๊ณ๋ณ๋ก ์คํํ๋ฉฐ ๊ณผ๊ฑฐ ์คํ ๊ธฐ๋ก์ ๊ฒํ ํฉ๋๋ค.
https://github.com/user-attachments/assets/1ebf78c9-94b2-468d-bbbb-566311df16fe
๐ธ๏ธ ์ PySpur์ธ๊ฐ?
- โ ํ ์คํธ ์ฃผ๋: ์ํฌํ๋ก์ฐ๋ฅผ ๊ตฌ์ถํ๊ณ , ํ ์คํธ ์ผ์ด์ค๋ฅผ ์คํํ๋ฉฐ, ๋ฐ๋ณตํฉ๋๋ค.
- ๐ค ์ธ๊ฐ ์ฐธ์ฌ ๋ฃจํ: ์ธ๊ฐ์ ์น์ธ ๋๋ ๊ฑฐ๋ถ๋ฅผ ๊ธฐ๋ค๋ฆฌ๋ ์ง์์ ์ธ ์ํฌํ๋ก์ฐ.
- ๐ ๋ฃจํ: ๋ฉ๋ชจ๋ฆฌ๋ฅผ ํ์ฉํ ๋ฐ๋ณต์ ๋๊ตฌ ํธ์ถ.
- ๐ค ํ์ผ ์ ๋ก๋: ํ์ผ์ ์ ๋ก๋ํ๊ฑฐ๋ URL์ ๋ถ์ฌ๋ฃ์ด ๋ฌธ์๋ฅผ ์ฒ๋ฆฌ.
- ๐ ๊ตฌ์กฐํ๋ ์ถ๋ ฅ: JSON ์คํค๋ง์ฉ UI ํธ์ง๊ธฐ.
- ๐๏ธ RAG: ๋ฐ์ดํฐ๋ฅผ ํ์ฑ, ์ฒญํน, ์๋ฒ ๋ฉ ๋ฐ ๋ฒกํฐ DB์ ์ ์ํธ.
- ๐ผ๏ธ ๋ฉํฐ๋ชจ๋ฌ: ๋น๋์ค, ์ด๋ฏธ์ง, ์ค๋์ค, ํ ์คํธ, ์ฝ๋ ์ง์.
- ๐งฐ ๋๊ตฌ: Slack, Firecrawl.dev, Google Sheets, GitHub ๋ฑ.
- ๐งช ํ๊ฐ: ์ค์ ๋ฐ์ดํฐ์ ์์ ์์ด์ ํธ ํ๊ฐ.
- ๐ ์ํด๋ฆญ ๋ฐฐํฌ: API๋ก ๋ฐํํ์ฌ ์ํ๋ ๊ณณ์ ํตํฉ.
- ๐ ํ์ด์ฌ ๊ธฐ๋ฐ: ๋จ์ผ ํ์ด์ฌ ํ์ผ ์์ฑ์ผ๋ก ์ ๋ ธ๋ ์ถ๊ฐ.
- ๐๏ธ ๋ชจ๋ ๋ฒค๋ ์ง์: 100๊ฐ ์ด์์ LLM ์ ๊ณต์ ์ฒด, ์๋ฒ ๋, ๋ฒกํฐ DB ์ง์.
โก ๋น ๋ฅธ ์์
์์ํ๋ ๊ฐ์ฅ ๋น ๋ฅธ ๋ฐฉ๋ฒ์ ๋๋ค. ํ์ด์ฌ 3.11 ์ด์์ด ํ์ํฉ๋๋ค.
-
PySpur ์ค์น:
pip install pyspur -
์ ํ๋ก์ ํธ ์ด๊ธฐํ:
pyspur init my-project cd my-project์ ๋๋ ํ ๋ฆฌ์ ํจ๊ป
.envํ์ผ์ด ์์ฑ๋ฉ๋๋ค. -
์๋ฒ ์์:
pyspur serve --sqlite๊ธฐ๋ณธ์ ์ผ๋ก SQLite ๋ฐ์ดํฐ๋ฒ ์ด์ค๋ฅผ ์ฌ์ฉํ์ฌ
http://localhost:6080์์ PySpur ์ฑ์ด ์์๋ฉ๋๋ค. ๋ณด๋ค ์์ ์ ์ธ ์ฌ์ฉ์ ์ํด.envํ์ผ์ PostgreSQL ์ธ์คํด์ค URL์ ์ค์ ํ๋ ๊ฒ์ ๊ถ์ฅํฉ๋๋ค. -
[์ ํ ์ฌํญ] ํ๊ฒฝ ๊ตฌ์ฑ ๋ฐ API ํค ์ถ๊ฐ:
- ์ฑ UI: API ํค ํญ์ผ๋ก ์ด๋ํ์ฌ ๊ณต๊ธ์ ํค(OpenAI, Anthropic ๋ฑ) ์ถ๊ฐ
- ์๋ ๊ตฌ์ฑ:
.envํ์ผ ํธ์ง(๊ถ์ฅ: postgres ๊ตฌ์ฑ) ํpyspur serve๋ก ์ฌ์์
โจ ํต์ฌ ์ด์
์ธ๊ฐ ์ฐธ์ฌ ์ค๋จ์ :
์ด๋ฌํ ์ค๋จ์ ์ ๋๋ฌํ์ ๋ ์ํฌํ๋ก์ฐ๋ฅผ ์ผ์ ์ค์งํ๊ณ ์ธ๊ฐ์ด ์น์ธํ๋ฉด ์ฌ๊ฐ๋ฉ๋๋ค. ํ์ง ๋ณด์ฆ์ด ํ์ํ ์ํฌํ๋ก์ฐ์ ์ธ๊ฐ์ ๊ฐ๋ ์ ๊ฐ๋ฅํ๊ฒ ํฉ๋๋ค: ์ํฌํ๋ก์ฐ๊ฐ ์งํ๋๊ธฐ ์ ์ ์ค์ํ ์ถ๋ ฅ์ ๊ฒ์ฆํฉ๋๋ค.
https://github.com/user-attachments/assets/98cb2b4e-207c-4d97-965b-4fee47c94ce8
๋ ธ๋ ๋ ๋ฒจ์์ ๋๋ฒ๊ทธ:
https://github.com/user-attachments/assets/6e82ad25-2a46-4c50-b030-415ea9994690
๋ฉํฐ๋ชจ๋ฌ (ํ์ผ ์ ๋ก๋ ๋๋ URL ๋ถ์ฌ๋ฃ๊ธฐ)
PDF, ๋น๋์ค, ์ค๋์ค, ์ด๋ฏธ์ง, ...
https://github.com/user-attachments/assets/83ed9a22-1ec1-4d86-9dd6-5d945588fd0b
๋ฃจํ
RAG
1๋จ๊ณ) ๋ฌธ์ ์ปฌ๋ ์ ์์ฑ (์ฒญํน + ํ์ฑ)
https://github.com/user-attachments/assets/c77723b1-c076-4a64-a01d-6d6677e9c60e
2๋จ๊ณ) ๋ฒกํฐ ์ธ๋ฑ์ค ์์ฑ (์๋ฒ ๋ฉ + ๋ฒกํฐ DB ์ ์ํธ)
https://github.com/user-attachments/assets/50e5c711-dd01-4d92-bb23-181a1c5bba25
๋ชจ๋ํ ๋น๋ฉ ๋ธ๋ก
https://github.com/user-attachments/assets/6442f0ad-86d8-43d9-aa70-e5c01e55e876
์ต์ข ์ฑ๋ฅ ํ๊ฐ
https://github.com/user-attachments/assets/4dc2abc3-c6e6-4d6d-a5c3-787d518de7ae
๊ณง ์ถ๊ฐ๋ ๊ธฐ๋ฅ: ์๊ธฐ ๊ฐ์
https://github.com/user-attachments/assets/5bef7a16-ef9f-4650-b385-4ea70fa54c8a
๐ ๏ธ PySpur ๊ฐ๋ฐ ํ๊ฒฝ ์ค์
[ ์ ๋์ค ๊ณ์ด ์์คํ ๊ฐ๋ฐ ์ง์นจ. Windows/PC ๊ฐ๋ฐ์ ์ง์๋์ง ์์ ]
๊ฐ๋ฐ์ ์ํด ์๋ ๋จ๊ณ๋ฅผ ๋ฐ๋ฅด์ธ์:
-
๋ฆฌํฌ์งํ ๋ฆฌ ํด๋ก :
git clone https://github.com/PySpur-com/pyspur.git cd pyspur -
docker-compose.dev.yml ์ฌ์ฉํ์ฌ ์คํ:
docker compose -f docker-compose.dev.yml up --build -d์ด ๋ช ๋ น์ด๋ ๊ฐ๋ฐ์ฉ ํซ ๋ฆฌ๋ก๋ฉ์ด ํ์ฑํ๋ ๋ก์ปฌ PySpur ์ธ์คํด์ค๋ฅผ ์์ํฉ๋๋ค.
-
ํ๊ฒฝ ์ค์ ๋ง์ถค: ํ๊ฒฝ ๊ตฌ์ฑ์ ์ํด
.envํ์ผ์ ์์ ํฉ๋๋ค. ๊ธฐ๋ณธ์ ์ผ๋ก PySpur๋ ๋ก์ปฌ PostgreSQL ๋ฐ์ดํฐ๋ฒ ์ด์ค๋ฅผ ์ฌ์ฉํฉ๋๋ค. ์ธ๋ถ ๋ฐ์ดํฐ๋ฒ ์ด์ค๋ฅผ ์ฌ์ฉํ๋ ค๋ฉด.envํ์ผ์POSTGRES_*๋ณ์๋ฅผ ์์ ํ์ธ์.
โญ ์ง์ํด ์ฃผ์ธ์
๋ณ์ ๋จ๊ฒจ ์ฃผ์ ์ ์ ํฌ์ ์์ ์ ์ง์ํ์ค ์ ์์ต๋๋ค! ๊ฐ์ฌํฉ๋๋ค!
์ฌ๋ฌ๋ถ์ ํผ๋๋ฐฑ์ ํฐ ํ์ด ๋ฉ๋๋ค. ๋ค์์ ๋ณด๊ณ ์ถ์ ๊ธฐ๋ฅ์ด๋ ์์ ํ ์๋ก์ด ๊ธฐ๋ฅ ์์ฒญ์ด ์๋ค๋ฉด ์๋ ค์ฃผ์ธ์.