humanda5 commited on
Commit
b97ab3c
ยท
1 Parent(s): 24c8b15

ai-agent-1.0.0v

Browse files
Files changed (2) hide show
  1. LICENSE +24 -0
  2. README.md +39 -6
LICENSE ADDED
@@ -0,0 +1,24 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ Copyright (c) 2025 Rorshi
2
+
3
+ ---
4
+ ๋ณธ ํ”„๋กœ์ ํŠธ๋Š” ํฌํŠธํด๋ฆฌ์˜ค ๋ฐ ์—ฐ๊ตฌ ๋ชฉ์ ์œผ๋กœ ์ž‘์„ฑ๋˜์—ˆ์œผ๋ฉฐ,
5
+ ์†Œ์Šค์ฝ”๋“œ, ๋ฌธ์„œ, ์ž๋ฃŒ์— ๋Œ€ํ•œ ์ €์ž‘๊ถŒ์€ ์ž‘์„ฑ์ž Rorshi์—๊ฒŒ ์žˆ์Šต๋‹ˆ๋‹ค.
6
+
7
+ ๋‹ค์Œ ํ–‰์œ„๋Š” **๋ช…์‹œ์ ์ธ ํ—ˆ๋ฝ ์—†์ด ๊ธˆ์ง€๋ฉ๋‹ˆ๋‹ค**:
8
+ - ์ „์ฒด ๋˜๋Š” ์ผ๋ถ€์˜ ๋ณต์ œ, ์ˆ˜์ •, ํฌํฌ, ๋ฐฐํฌ
9
+ - ์ƒ์—…์  ์ด์šฉ
10
+ - ๋‹ค๋ฅธ ํ”„๋กœ์ ํŠธ์—์„œ์˜ 2์ฐจ ์‚ฌ์šฉ
11
+
12
+ ์ด ํ”„๋กœ์ ํŠธ๋ฅผ ์‚ฌ์šฉํ•˜๊ฑฐ๋‚˜ ์ฐธ๊ณ ํ•˜๊ณ  ์‹ถ์œผ์‹  ๊ฒฝ์šฐ, ์•„๋ž˜ ์ด๋ฉ”์ผ๋กœ ๋ฌธ์˜ํ•ด ์ฃผ์„ธ์š”:
13
+ ---
14
+ This project was created for portfolio and research purposes.
15
+ All source code, documentation, and materials are copyrighted by the author, Rorshi.
16
+
17
+ The following actions are **prohibited without explicit permission**:
18
+ - Copying, modifying, forking, or redistributing all or part of the project
19
+ - Commercial use of any kind
20
+ - Secondary use in other projects
21
+
22
+ If you wish to use, reference, or build upon this project, please contact the author at the email address below:
23
+ ---
24
+ Contact: [email protected]
README.md CHANGED
@@ -5,8 +5,8 @@
5
  ![Flask](https://img.shields.io/badge/Flask-Web_Framework-black?logo=flask)
6
  ![License](https://img.shields.io/badge/License-MIT-green)
7
  <br>
8
- <br>
9
- ## ๐Ÿ“ ํ”„๋กœ์ ํŠธ ์†Œ๊ฐœ
10
  ์ด ํ”„๋กœ์ ํŠธ๋Š” ๋‹จ์ˆœํžˆ ์ •ํ•ด์ง„ ๋Œ€์‚ฌ๋ฅผ ๋ฐ˜๋ณตํ•˜๋Š” ๊ฒŒ์ž„ NPC๋ฅผ ๋„˜์–ด, ์ž์ฒด์ ์ธ ๊ฐ์ •, ๊ธฐ์–ต, ์„ฑ๊ฒฉ, ๊ด€๊ณ„๋ฅผ ๋ฐ”ํƒ•์œผ๋กœ ์ƒํ˜ธ์ž‘์šฉํ•˜๋ฉฐ<br>
11
  <strong>์Šค์Šค๋กœ ํŒ๋‹จํ•˜๊ณ  ์„ฑ์žฅํ•˜๋Š” ๊ฐ€์ƒ ์ธ๊ฐ„(AI Agent)</strong>์„ ๊ตฌํ˜„ํ•˜๋Š” AI ์‹œ๋ฎฌ๋ ˆ์ด์…˜์ž…๋‹ˆ๋‹ค.
12
 
@@ -15,7 +15,7 @@
15
  - **์ฃผ์š” ๊ธฐ๋Šฅ**: ์ž์œจ ํ–‰๋™, ๊ธฐ์–ต ๊ธฐ๋ฐ˜ ๋Œ€ํ™”, ๊ฐ€์น˜๊ด€ ํ˜•์„ฑ, ์„ฑ๊ฒฉ/๊ด€๊ณ„ ๋ณ€ํ™”, ํ”Œ๋ ˆ์ด์–ด ๊ฐœ์ž… ๋“ฑ
16
  <br>
17
 
18
- ## ๐Ÿš€ ์ฃผ์š” ๊ธฐ๋Šฅ ๋ฐ ์‹œ์Šคํ…œ
19
  ### ๐Ÿงฉ ๋™์  ๋ฉ€ํ‹ฐํ„ด ๋Œ€ํ™” ์‹œ์Šคํ…œ
20
  - ๋‹จ๋‹ตํ˜• ๋ฌธ๋‹ต์„ ๋„˜์–ด, NPC์˜ ๊ฐ์ •, ๊ธฐ์–ต, ๊ด€๊ณ„๋ฅผ ํ™œ์šฉํ•œ ๊นŠ์ด ์žˆ๋Š” ๋Œ€ํ™”
21
 
@@ -35,6 +35,39 @@
35
  - ๊ด€๊ณ„ ์„ค์ •, ์ด๋ฒคํŠธ ์œ ๋„ ๋“ฑ์œผ๋กœ NPC ์„ธ๊ณ„์— ์‹ค์‹œ๊ฐ„ ๊ฐœ์ž… ๊ฐ€๋Šฅ
36
  <br>
37
 
38
- ## ๐Ÿ–ผ๏ธ ์‹œ๊ฐํ™”: ์›”๋“œ ๊ด€์ฐฐ์ž ๋Œ€์‹œ๋ณด๋“œ
39
- NPC๋“ค์˜ ๋‚ด๋ฉด ์ƒํƒœ์™€ ๊ด€๊ณ„ ๋ณ€ํ™”๋ฅผ ์‹ค์‹œ๊ฐ„์œผ๋กœ ์‹œ๊ฐํ™”ํ•˜๋Š” ์›น ๊ธฐ๋ฐ˜ ๋Œ€์‹œ๋ณด๋“œ์ž…๋‹ˆ๋‹ค.
40
- ![Dashboard Example](./npc_social_network/static/dashboard_example.png)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
5
  ![Flask](https://img.shields.io/badge/Flask-Web_Framework-black?logo=flask)
6
  ![License](https://img.shields.io/badge/License-MIT-green)
7
  <br>
8
+
9
+ ## ๐Ÿ“ 1. ํ”„๋กœ์ ํŠธ ์†Œ๊ฐœ
10
  ์ด ํ”„๋กœ์ ํŠธ๋Š” ๋‹จ์ˆœํžˆ ์ •ํ•ด์ง„ ๋Œ€์‚ฌ๋ฅผ ๋ฐ˜๋ณตํ•˜๋Š” ๊ฒŒ์ž„ NPC๋ฅผ ๋„˜์–ด, ์ž์ฒด์ ์ธ ๊ฐ์ •, ๊ธฐ์–ต, ์„ฑ๊ฒฉ, ๊ด€๊ณ„๋ฅผ ๋ฐ”ํƒ•์œผ๋กœ ์ƒํ˜ธ์ž‘์šฉํ•˜๋ฉฐ<br>
11
  <strong>์Šค์Šค๋กœ ํŒ๋‹จํ•˜๊ณ  ์„ฑ์žฅํ•˜๋Š” ๊ฐ€์ƒ ์ธ๊ฐ„(AI Agent)</strong>์„ ๊ตฌํ˜„ํ•˜๋Š” AI ์‹œ๋ฎฌ๋ ˆ์ด์…˜์ž…๋‹ˆ๋‹ค.
12
 
 
15
  - **์ฃผ์š” ๊ธฐ๋Šฅ**: ์ž์œจ ํ–‰๋™, ๊ธฐ์–ต ๊ธฐ๋ฐ˜ ๋Œ€ํ™”, ๊ฐ€์น˜๊ด€ ํ˜•์„ฑ, ์„ฑ๊ฒฉ/๊ด€๊ณ„ ๋ณ€ํ™”, ํ”Œ๋ ˆ์ด์–ด ๊ฐœ์ž… ๋“ฑ
16
  <br>
17
 
18
+ ## ๐Ÿš€ 2. ์ฃผ์š” ๊ธฐ๋Šฅ ๋ฐ ์‹œ์Šคํ…œ
19
  ### ๐Ÿงฉ ๋™์  ๋ฉ€ํ‹ฐํ„ด ๋Œ€ํ™” ์‹œ์Šคํ…œ
20
  - ๋‹จ๋‹ตํ˜• ๋ฌธ๋‹ต์„ ๋„˜์–ด, NPC์˜ ๊ฐ์ •, ๊ธฐ์–ต, ๊ด€๊ณ„๋ฅผ ํ™œ์šฉํ•œ ๊นŠ์ด ์žˆ๋Š” ๋Œ€ํ™”
21
 
 
35
  - ๊ด€๊ณ„ ์„ค์ •, ์ด๋ฒคํŠธ ์œ ๋„ ๋“ฑ์œผ๋กœ NPC ์„ธ๊ณ„์— ์‹ค์‹œ๊ฐ„ ๊ฐœ์ž… ๊ฐ€๋Šฅ
36
  <br>
37
 
38
+ ## ๐Ÿ–ผ๏ธ 3. ์‹œ๊ฐํ™”: ์›”๋“œ ๊ด€์ฐฐ์ž ๋Œ€์‹œ๋ณด๋“œ
39
+ > NPC๋“ค์˜ ๋‚ด๋ฉด ์ƒํƒœ์™€ ๊ด€๊ณ„ ๋ณ€ํ™”๋ฅผ ์‹ค์‹œ๊ฐ„์œผ๋กœ ์‹œ๊ฐํ™”ํ•˜๋Š” ์›น ๊ธฐ๋ฐ˜ ๋Œ€์‹œ๋ณด๋“œ์ž…๋‹ˆ๋‹ค.<br>
40
+ ![Dashboard Example](/npc_social_network/static/images/assets/dashboard_example.png)
41
+ <br>
42
+
43
+ ## ๐Ÿงฐ 4. ์‚ฌ์šฉ ๊ธฐ์ˆ  ์Šคํƒ
44
+ - **AI/ML**: Google Gemini, Sentence-Transformers, FAISS
45
+ - **Frontend**: HTML, CSS
46
+ - **Backend**: Python 3.10, Flask
47
+ - **Memory Architecture**: RAG
48
+ <br>
49
+
50
+ ## โš™๏ธ 5. ์„ค์น˜ ๋ฐ ์‹คํ–‰ ๋ฐฉ๋ฒ•
51
+ ```bash
52
+ # 1. ํด๋ก 
53
+ git clone http://github.com/Rorshi/autonomous-ai-agent-sim.git
54
+ cd autonomous-ai-agent-sim
55
+
56
+ # 2. ํ•„์š” ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ์„ค์น˜
57
+ pip install -r requirements.txt
58
+
59
+ # 3. ์‹คํ–‰
60
+ python app.py
61
+ http://127.0.0.1:5000 ์ ‘์†
62
+
63
+ # 4. LLM ๋ชจ๋ธ ์„ ํƒ ๋ฐ API Key ์ž…๋ ฅ
64
+
65
+ # 5. ์‹œ์ž‘ ์„ค์ •(์„ ํƒ ์‚ฌํ•ญ)
66
+ autonomous-ai-agent-sim\npc_social_network\scenarios\scenario_setup.py ํŒŒ์ผ ์ˆ˜์ •
67
+ ```
68
+
69
+ ## ๐Ÿค 6. ๊ธฐ์—ฌ / ๋ผ์ด์„ ์Šค
70
+ - ์ด ํ”„๋กœ์ ํŠธ๋Š” **๊ฐœ์ธ ํฌํŠธํด๋ฆฌ์˜ค ๋ฐ ์—ฐ๊ตฌ ๋ชฉ์ **์œผ๋กœ ์ œ์ž‘๋˜์—ˆ์Šต๋‹ˆ๋‹ค.
71
+ - ์™ธ๋ถ€ ์‚ฌ์šฉ์ž์˜ Issue ๋ฐ Pull Request๋Š” ๊ฒ€ํ†  ํ›„ ๋ฐ˜์˜ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
72
+ - ์ด ํ”„๋กœ์ ํŠธ์˜ ์ €์ž‘๊ถŒ์€ <strong>[@Rorshi](https://github.com/Rorshi)</strong>์—๊ฒŒ ์žˆ์œผ๋ฉฐ, ๋ฌด๋‹จ ์‚ฌ์šฉ, ์ˆ˜์ •, ๋ฐฐํฌ๋ฅผ ๊ธˆ์ง€ํ•ฉ๋‹ˆ๋‹ค.
73
+ > โœ‰๏ธ ์ด์šฉ ๋ฐ ํ˜‘์—… ๋ฌธ์˜: [email protected]