Communitygithub.com

smartflat-ai

๐Ÿค– ๋น„์šฉ ์ตœ์ ํ™”๋œ ๋‹ค์ค‘ ์—์ด์ „ํŠธ ์‹œ์Šคํ…œ๊ณผ AWS๋ฅผ ํ™œ์šฉํ•œ ์ง€๋Šฅํ˜• ๋ฐ์ดํ„ฐ ๋ผ์šฐํŒ… ๋ฐ ๋ถ„์„์œผ๋กœ HDB ๋ถ€๋™์‚ฐ ์ถ”์ฒœ์„ ๊ฐ„์†Œํ™”ํ•ฉ๋‹ˆ๋‹ค.

smartflat-ai๋ž€ ๋ฌด์—‡์ธ๊ฐ€์š”?

์ด ์Šคํ‚ฌ์€ ์‹ฑ๊ฐ€ํฌ๋ฅด HDB(์ฃผํƒ๊ฐœ๋ฐœ์œ„์›ํšŒ) ๋ถ€๋™์‚ฐ ์ถ”์ฒœ์„ ๊ฐ„์†Œํ™”ํ•˜๊ธฐ ์œ„ํ•ด ์„ค๊ณ„๋œ ๋‹ค์ค‘ ์—์ด์ „ํŠธ ์‹œ์Šคํ…œ์ž…๋‹ˆ๋‹ค. AWS ์„œ๋น„์Šค๋ฅผ ํ™œ์šฉํ•˜์—ฌ ์ง€๋Šฅํ˜• ๋ฐ์ดํ„ฐ ๋ผ์šฐํŒ… ๋ฐ ๋ถ„์„์„ ์ˆ˜ํ–‰ํ•˜๋ฉฐ, ์‚ฌ์šฉ์ž ์„ ํ˜ธ๋„์™€ ์˜ˆ์‚ฐ์— ์ตœ์ ํ™”๋œ ๋ถ€๋™์‚ฐ ์˜ต์…˜์„ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค. ๊ฐœ๋ฐœ์ž๋Š” ์ด ์Šคํ‚ฌ์„ ํ†ตํ•ด ๋Œ€๊ทœ๋ชจ ๋ถ€๋™์‚ฐ ๋ฐ์ดํ„ฐ๋ฅผ ํšจ์œจ์ ์œผ๋กœ ์ฒ˜๋ฆฌํ•˜๊ณ , ๋น„์šฉ ํšจ์œจ์ ์ธ ์ถ”์ฒœ ์•Œ๊ณ ๋ฆฌ์ฆ˜์„ ์‰ฝ๊ฒŒ ํ†ตํ•ฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์ฃผ์š” ํ”Œ๋žซํผ(Claude Code, Cursor ๋“ฑ)๊ณผ ํ˜ธํ™˜๋˜๋ฉฐ, ์—์ด์ „ํŠธ ์ƒํ˜ธ์ž‘์šฉ์„ ํ†ตํ•ด ๋ณต์žกํ•œ ๋ถ€๋™์‚ฐ ๊ฒ€์ƒ‰ ์กฐ๊ฑด์„ ์ž๋™์œผ๋กœ ๋ถ„์„ํ•˜๊ณ  ์ตœ์ ์˜ ๊ฒฐ๊ณผ๋ฅผ ๋„์ถœํ•ฉ๋‹ˆ๋‹ค.

์ง€์› ๋Œ€์ƒ~Claude Code~Codex CLI~Cursor
npx skills add marekre352/smartflat-ai

์ฆ๊ฒจ ์‚ฌ์šฉํ•˜๋Š” AI์—๊ฒŒ ๋ฌผ์–ด๋ณด๊ธฐ

์ด ์—์ด์ „ํŠธ ์Šคํ‚ฌ์ด ๋ฏธ๋ฆฌ ๋กœ๋“œ๋œ ์ƒˆ ์ฑ„ํŒ…์„ ์—ฝ๋‹ˆ๋‹ค.

๋ฌธ์„œ

smartflat-ai์€(๋Š”) ๋ฌด์—‡์„ ํ•˜๋‚˜์š”?

๐Ÿค– ๋น„์šฉ ์ตœ์ ํ™”๋œ ๋‹ค์ค‘ ์—์ด์ „ํŠธ ์‹œ์Šคํ…œ๊ณผ AWS๋ฅผ ํ™œ์šฉํ•œ ์ง€๋Šฅํ˜• ๋ฐ์ดํ„ฐ ๋ผ์šฐํŒ… ๋ฐ ๋ถ„์„์œผ๋กœ HDB ๋ถ€๋™์‚ฐ ์ถ”์ฒœ์„ ๊ฐ„์†Œํ™”ํ•ฉ๋‹ˆ๋‹ค.

๊ฐœ์š”

์ด ํ”„๋กœ์ ํŠธ๋Š” AWS ํด๋ผ์šฐ๋“œ ์ธํ”„๋ผ๋ฅผ ๊ธฐ๋ฐ˜์œผ๋กœ ์—ฌ๋Ÿฌ AI ์—์ด์ „ํŠธ๊ฐ€ ํ˜‘๋ ฅํ•˜์—ฌ ์‚ฌ์šฉ์ž์˜ ์š”๊ตฌ์— ๋งž๋Š” HDB ๋ถ€๋™์‚ฐ์„ ์ถ”์ฒœํ•ฉ๋‹ˆ๋‹ค. ๊ฐ ์—์ด์ „ํŠธ๋Š” ํŠน์ • ์—ญํ• (์˜ˆ: ๋ฐ์ดํ„ฐ ์ˆ˜์ง‘, ๋น„์šฉ ๋ถ„์„, ์œ„์น˜ ์ตœ์ ํ™”)์„ ๋‹ด๋‹นํ•˜๋ฉฐ, ์ค‘์•™ ๋ผ์šฐํ„ฐ๊ฐ€ ์ž‘์—…์„ ์ง€๋Šฅ์ ์œผ๋กœ ๋ถ„๋ฐฐํ•ฉ๋‹ˆ๋‹ค.

์ฃผ์š” ๊ธฐ๋Šฅ

  • ์ง€๋Šฅํ˜• ๋ฐ์ดํ„ฐ ๋ผ์šฐํŒ…: ์‚ฌ์šฉ์ž ์ž…๋ ฅ์„ ๋ถ„์„ํ•˜์—ฌ ์ ์ ˆํ•œ ์—์ด์ „ํŠธ์— ์ž‘์—…์„ ํ• ๋‹นํ•ฉ๋‹ˆ๋‹ค.
  • ๋น„์šฉ ์ตœ์ ํ™”: ์˜ˆ์‚ฐ, ์œ„์น˜, ์‹œ์„ค ๋“ฑ์„ ๊ณ ๋ คํ•œ ์ตœ์ ์˜ ๋ถ€๋™์‚ฐ ์˜ต์…˜์„ ์ œ์‹œํ•ฉ๋‹ˆ๋‹ค.
  • ๋‹ค์ค‘ ์—์ด์ „ํŠธ ํ˜‘์—…: ๊ฐ ์—์ด์ „ํŠธ๊ฐ€ ์ „๋ฌธ ๋ถ„์•ผ์—์„œ ๋ฐ์ดํ„ฐ๋ฅผ ์ฒ˜๋ฆฌํ•˜๊ณ  ์ข…ํ•ฉ์ ์ธ ์ถ”์ฒœ์„ ์ƒ์„ฑํ•ฉ๋‹ˆ๋‹ค.
  • AWS ํ†ตํ•ฉ: Lambda, S3, DynamoDB ๋“ฑ AWS ์„œ๋น„์Šค๋ฅผ ํ™œ์šฉํ•˜์—ฌ ํ™•์žฅ ๊ฐ€๋Šฅํ•˜๊ณ  ์•ˆ์ •์ ์ธ ์‹œ์Šคํ…œ์„ ๊ตฌ์ถ•ํ•ฉ๋‹ˆ๋‹ค.

์‚ฌ์šฉ ๋ฐฉ๋ฒ•

  1. ์ €์žฅ์†Œ๋ฅผ ํด๋ก ํ•ฉ๋‹ˆ๋‹ค:

    git clone https://github.com/marekre352/smartflat-ai.git
    cd smartflat-ai
    
  2. AWS ์ž๊ฒฉ ์ฆ๋ช…์„ ์„ค์ •ํ•ฉ๋‹ˆ๋‹ค:

    export AWS_ACCESS_KEY_ID=your_access_key
    export AWS_SECRET_ACCESS_KEY=your_secret_key
    export AWS_DEFAULT_REGION=ap-southeast-1
    
  3. ์˜์กด์„ฑ์„ ์„ค์น˜ํ•ฉ๋‹ˆ๋‹ค:

    pip install -r requirements.txt
    
  4. ์‹œ์Šคํ…œ์„ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค:

    python main.py
    

์•„ํ‚คํ…์ฒ˜

+-------------------+       +------------------+
| ์‚ฌ์šฉ์ž ์ž…๋ ฅ       | ----> | ์—์ด์ „ํŠธ ๋ผ์šฐํ„ฐ   |
+-------------------+       +------------------+
                                      |
          +---------------------------+----------------------------+
          |                           |                            |
          v                           v                            v
+------------------+      +------------------+      +------------------+
| ๋ฐ์ดํ„ฐ ์ˆ˜์ง‘ ์—์ด์ „ํŠธ |      | ๋น„์šฉ ๋ถ„์„ ์—์ด์ „ํŠธ  |      | ์œ„์น˜ ์ตœ์ ํ™” ์—์ด์ „ํŠธ |
+------------------+      +------------------+      +------------------+
          |                           |                            |
          v                           v                            v
+------------------------------------------------------------------+
|                          AWS ์ธํ”„๋ผ (Lambda, S3, DynamoDB)         |
+------------------------------------------------------------------+
          |
          v
+------------------+
| ์ตœ์ข… ์ถ”์ฒœ ์ถœ๋ ฅ    |
+------------------+

ํ™˜๊ฒฝ ๋ณ€์ˆ˜

๋ณ€์ˆ˜๋ช…์„ค๋ช…ํ•„์ˆ˜ ์—ฌ๋ถ€
AWS_ACCESS_KEY_IDAWS ์•ก์„ธ์Šค ํ‚ค์˜ˆ
AWS_SECRET_ACCESS_KEYAWS ์‹œํฌ๋ฆฟ ํ‚ค์˜ˆ
AWS_DEFAULT_REGIONAWS ๋ฆฌ์ „ (๊ธฐ๋ณธ๊ฐ’: ap-southeast-1)์•„๋‹ˆ์˜ค

๋ผ์ด์„ ์Šค

์ด ํ”„๋กœ์ ํŠธ๋Š” MIT ๋ผ์ด์„ ์Šค ํ•˜์— ๋ฐฐํฌ๋ฉ๋‹ˆ๋‹ค.

๊ธฐ์—ฌ

๋ฒ„๊ทธ ์ œ๋ณด, ๊ธฐ๋Šฅ ์š”์ฒญ, ํ’€ ๋ฆฌํ€˜์ŠคํŠธ๋ฅผ ํ™˜์˜ํ•ฉ๋‹ˆ๋‹ค. ์ž์„ธํ•œ ๋‚ด์šฉ์€ CONTRIBUTING.md๋ฅผ ์ฐธ์กฐํ•˜์„ธ์š”.

๊ด€๋ จ ์Šคํ‚ฌ