benjamin5607 commited on
Commit
21b0169
ยท
verified ยท
1 Parent(s): ae299bc

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +24 -18
README.md CHANGED
@@ -1,34 +1,40 @@
 
 
 
 
 
 
 
 
 
 
 
1
  # ๐Ÿ”ฎ AI ๋งŒ์‹ ์ „ (The AI Pantheon)
2
 
3
  > **"๋‹น์‹ ์˜ ์šด๋ช…์„ ์ฝ์–ด์ฃผ๋Š” ๋ฉ€ํ‹ฐ ํŽ˜๋ฅด์†Œ๋‚˜ AI ์ ์ง‘"**
4
 
5
- AI ๋งŒ์‹ ์ „์€ ๋‹จ์ˆœํ•œ ์ฑ—๋ด‡์ด ์•„๋‹™๋‹ˆ๋‹ค. **Streamlit**๊ณผ **LLM(Large Language Model)** ๊ธฐ์ˆ ์„ ๊ฒฐํ•ฉํ•˜์—ฌ, ์ƒํ™ฉ์— ๋”ฐ๋ผ ์ „ํ˜€ ๋‹ค๋ฅธ ์ธ๊ฒฉ(Persona)๊ณผ ์ „๋ฌธ ์ง€์‹์„ ๊ฐ€์ง„ AI ์ƒ๋‹ด์‚ฌ๋ฅผ ๋งŒ๋‚  ์ˆ˜ ์žˆ๋Š” ์ธํ„ฐ๋ž™ํ‹ฐ๋ธŒ ์šด์„ธ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์ž…๋‹ˆ๋‹ค.
6
 
7
  ## ๐ŸŒŸ ์ฃผ์š” ๊ธฐ๋Šฅ (Key Features)
8
 
9
  ### 1. 3๊ฐ€์ง€ ๋ฉ€ํ‹ฐ ํŽ˜๋ฅด์†Œ๋‚˜ ๋ชจ๋“œ
10
- - **๐Ÿƒ ํƒ€๋กœ ๋งˆ์Šคํ„ฐ (The Mystic)**: ์„œ์–‘์˜ ์‹ ๋น„๋กœ์šด ๋งˆ๋ฒ•์‚ฌ ํ†ค. 78์žฅ ํƒ€๋กœ ์นด๋“œ์˜ ์ƒ์ง•์„ ๋ถ„์„ํ•˜์—ฌ ๊ณผ๊ฑฐ/ํ˜„์žฌ/๋ฏธ๋ž˜๋ฅผ ํ•ด์„ํ•ฉ๋‹ˆ๋‹ค.
11
- - **๐Ÿก ํ’์ˆ˜์ง€๋ฆฌ ๋Œ€๊ฐ€ (The Master)**: 40๋…„ ๊ฒฝ๋ ฅ์˜ ๊น๊นํ•œ ๋…ธ๊ต์ˆ˜ ํ†ค. ๊ณต๊ฐ„์˜ ๊ตฌ์กฐ์™€ ๊ธฐ์˜ ํ๋ฆ„์„ ๋ถ„์„ํ•˜์—ฌ ์ธํ…Œ๋ฆฌ์–ด ์กฐ์–ธ์„ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.
12
- - **๐Ÿ‘น ์šฉํ•œ ์‹ ์ ์Ÿ์ด (The Shaman)**: **(ํ‚ฌ๋ง ํฌ์ธํŠธ)** ์˜ˆ์˜ ์—†๋Š” ๋ฐ˜๋ง๊ณผ ํ˜ธํ†ต์„ ์น˜๋Š” ๋ฌด๋‹น ์ปจ์…‰. ์‚ฌ์šฉ์ž์˜ ๋ฉ˜ํƒˆ์„ ํ”๋“ค๋ฉฐ ํ•ต์‹ฌ์„ ์ฐŒ๋ฅด๋Š” ์กฐ์–ธ์„ ํ•ฉ๋‹ˆ๋‹ค.
13
 
14
  ### 2. ์ธํ„ฐ๋ž™ํ‹ฐ๋ธŒ ํƒ€๋กœ ๋ฆฌ๋”ฉ
15
  - ๋‹จ์ˆœํžˆ ํ…์ŠคํŠธ๋งŒ ์ž…๋ ฅํ•˜๋Š” ๊ฒƒ์ด ์•„๋‹ˆ๋ผ, ์‚ฌ์šฉ์ž๊ฐ€ **์ง์ ‘ ์นด๋“œ๋ฅผ ๋ฝ‘๋Š” ๊ฒฝํ—˜(UX)**์„ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.
16
- - `Input` โ†’ `Picking` โ†’ `Reading` 3๋‹จ๊ณ„ ์ƒํƒœ ๊ด€๋ฆฌ(State Management)๋ฅผ ํ†ตํ•ด ์‹ค์ œ ์ƒ๋‹ด๊ณผ ์œ ์‚ฌํ•œ ๋ชฐ์ž…๊ฐ์„ ์ค๋‹ˆ๋‹ค.
17
-
18
- ### 3. ํ™•์žฅ ๊ฐ€๋Šฅํ•œ ์•„ํ‚คํ…์ฒ˜
19
- - `utils/` ํด๋”๋ฅผ ํ†ตํ•ด ๋กœ์ง(Logic), ๋ฐ์ดํ„ฐ(Data), ํ”„๋กฌํ”„ํŠธ(Prompt)๋ฅผ ๋ถ„๋ฆฌํ•˜์—ฌ ์œ ์ง€๋ณด์ˆ˜๊ฐ€ ์‰ฝ์Šต๋‹ˆ๋‹ค.
20
- - ํ˜„์žฌ๋Š” ์‹œ๋ฎฌ๋ ˆ์ด์…˜ ๋ชจ๋“œ(Mock Data)๋กœ ๋™์ž‘ํ•˜์ง€๋งŒ, ์ถ”ํ›„ `Ollama` ๋˜๋Š” `OpenAI API`๋งŒ ์—ฐ๊ฒฐํ•˜๋ฉด ์ฆ‰์‹œ ์‹ค์„œ๋น„์Šค๊ฐ€ ๊ฐ€๋Šฅํ•ฉ๋‹ˆ๋‹ค.
21
 
22
  ---
23
 
24
- ## ๐Ÿ“‚ ํ”„๋กœ์ ํŠธ ๊ตฌ์กฐ (File Structure)
25
 
26
  ```text
27
- ai-pantheon/
28
- โ”œโ”€โ”€ main.py # ๐Ÿš€ ์•ฑ ์‹คํ–‰ ์ง„์ž…์  (UI ๋ฐ ๋ผ์šฐํŒ…)
29
- โ”œโ”€โ”€ requirements.txt # ๐Ÿ“ฆ ํ•„์š”ํ•œ ํŒŒ์ด์ฌ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ๋ชฉ๋ก
30
- โ”œโ”€โ”€ README.md # ๐Ÿ“„ ํ”„๋กœ์ ํŠธ ์„ค๋ช…์„œ
31
- โ””โ”€โ”€ utils/ # ๐Ÿ”ง ํ•ต์‹ฌ ๊ธฐ๋Šฅ ๋ชจ๋“ˆ
32
- โ”œโ”€โ”€ tarot.py # ๐Ÿƒ ํƒ€๋กœ ์นด๋“œ ๋ฐ์ดํ„ฐ ๋ฐ ๋ฑ ๊ด€๋ฆฌ
33
- โ”œโ”€โ”€ prompts.py # ๐ŸŽญ AI ํŽ˜๋ฅด์†Œ๋‚˜(System Prompt) ์ •์˜
34
- โ””โ”€โ”€ llm.py # ๐Ÿง  AI ๋ชจ๋ธ ์—ฐ๋™ ๋ฐ ์‘๋‹ต ์ƒ์„ฑ (ํ˜„์žฌ: Simulation)
 
1
+ ---
2
+ title: AI Pantheon
3
+ emoji: ๐Ÿ”ฎ
4
+ colorFrom: purple
5
+ colorTo: indigo
6
+ sdk: streamlit
7
+ sdk_version: 1.31.0
8
+ app_file: main.py
9
+ pinned: false
10
+ ---
11
+
12
  # ๐Ÿ”ฎ AI ๋งŒ์‹ ์ „ (The AI Pantheon)
13
 
14
  > **"๋‹น์‹ ์˜ ์šด๋ช…์„ ์ฝ์–ด์ฃผ๋Š” ๋ฉ€ํ‹ฐ ํŽ˜๋ฅด์†Œ๋‚˜ AI ์ ์ง‘"**
15
 
16
+ AI ๋งŒ์‹ ์ „์€ **Streamlit**๊ณผ **LLM(Large Language Model)** ๊ธฐ์ˆ ์„ ๊ฒฐํ•ฉํ•˜์—ฌ, ์ƒํ™ฉ์— ๋”ฐ๋ผ ์ „ํ˜€ ๋‹ค๋ฅธ ์ธ๊ฒฉ(Persona)๊ณผ ์ „๋ฌธ ์ง€์‹์„ ๊ฐ€์ง„ AI ์ƒ๋‹ด์‚ฌ๋ฅผ ๋งŒ๋‚  ์ˆ˜ ์žˆ๋Š” ์ธํ„ฐ๋ž™ํ‹ฐ๋ธŒ ์šด์„ธ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์ž…๋‹ˆ๋‹ค.
17
 
18
  ## ๐ŸŒŸ ์ฃผ์š” ๊ธฐ๋Šฅ (Key Features)
19
 
20
  ### 1. 3๊ฐ€์ง€ ๋ฉ€ํ‹ฐ ํŽ˜๋ฅด์†Œ๋‚˜ ๋ชจ๋“œ
21
+ - **๐Ÿƒ ํƒ€๋กœ ๋งˆ์Šคํ„ฐ (The Mystic)**: ์„œ์–‘์˜ ์‹ ๋น„๋กœ์šด ๋งˆ๋ฒ•์‚ฌ ํ†ค. ํƒ€๋กœ ์นด๋“œ์˜ ์ƒ์ง•์„ ๋ถ„์„ํ•ฉ๋‹ˆ๋‹ค.
22
+ - **๐Ÿก ํ’์ˆ˜์ง€๋ฆฌ ๋Œ€๊ฐ€ (The Master)**: 40๋…„ ๊ฒฝ๋ ฅ์˜ ๊น๊นํ•œ ๋…ธ๊ต์ˆ˜ ํ†ค. ๊ณต๊ฐ„์˜ ๊ธฐ ํ๋ฆ„์„ ๋ถ„์„ํ•ฉ๋‹ˆ๋‹ค.
23
+ - **๐Ÿ‘น ์šฉํ•œ ์‹ ์ ์Ÿ์ด (The Shaman)**: **(ํ•ต์‹ฌ)** ๋ฐ˜๋ง๊ณผ ํ˜ธํ†ต์„ ์น˜๋Š” ๋ฌด๋‹น ์ปจ์…‰. ํŒฉํŠธ ํญ๊ฒฉ์„ ๋‚ ๋ฆฝ๋‹ˆ๋‹ค.
24
 
25
  ### 2. ์ธํ„ฐ๋ž™ํ‹ฐ๋ธŒ ํƒ€๋กœ ๋ฆฌ๋”ฉ
26
  - ๋‹จ์ˆœํžˆ ํ…์ŠคํŠธ๋งŒ ์ž…๋ ฅํ•˜๋Š” ๊ฒƒ์ด ์•„๋‹ˆ๋ผ, ์‚ฌ์šฉ์ž๊ฐ€ **์ง์ ‘ ์นด๋“œ๋ฅผ ๋ฝ‘๋Š” ๊ฒฝํ—˜(UX)**์„ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.
27
+ - `Input` โ†’ `Picking` โ†’ `Reading` 3๋‹จ๊ณ„ ์ƒํƒœ ๊ด€๋ฆฌ(State Management) ์ ์šฉ.
 
 
 
 
28
 
29
  ---
30
 
31
+ ## ๐Ÿ“‚ ํŒŒ์ผ ๊ตฌ์กฐ (File Structure)
32
 
33
  ```text
34
+ .
35
+ โ”œโ”€โ”€ main.py # ๐Ÿš€ ์‹คํ–‰ ํŒŒ์ผ (Hugging Face ์„ค์ •์˜ app_file)
36
+ โ”œโ”€โ”€ requirements.txt # ๐Ÿ“ฆ ํŒจํ‚ค์ง€ ๋ชฉ๋ก
37
+ โ””โ”€โ”€ utils/ # ๐Ÿ”ง ๊ธฐ๋Šฅ ๋ชจ๋“ˆ ํด๋”
38
+ โ”œโ”€โ”€ tarot.py
39
+ โ”œโ”€โ”€ prompts.py
40
+ โ””โ”€โ”€ llm.py