Skip to content
View rayvoidx's full-sized avatar
๐Ÿปโ€โ„๏ธ
๐Ÿปโ€โ„๏ธ

Highlights

  • Pro

Block or report rayvoidx

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please donโ€™t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this userโ€™s behavior. Learn more about reporting abuse.

Report abuse
rayvoidx/README.md

Email GitHub


๐Ÿš€ Flagship Project โ€” Social Trend Agent

์ž์œจ ๋ฉ€ํ‹ฐ ์—์ด์ „ํŠธ ํŠธ๋ Œ๋“œ ์ธํ…”๋ฆฌ์ „์Šค ์‹œ์Šคํ…œ

์—์ด์ „ํŠธ๊ฐ€ ์ž์œจ์ ์œผ๋กœ ๊ณ„ํš, ์ˆ˜์ง‘, ๋ถ„์„, ๋ณด๊ณ ํ•˜๋Š” ํŠธ๋ Œ๋“œ ๋ถ„์„ ์‹œ์Šคํ…œ โ€” LangGraph ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜, MCP ๋„๊ตฌ ํ”„๋กœํ† ์ฝœ, ์—์ด์ „ํ‹ฑ ๋„๊ตฌ ํ˜ธ์ถœ ๋ฃจํ”„ ๊ธฐ๋ฐ˜


v1.3.0 Python 3.11+ LangGraph FastAPI React 19 Docker


License


์‹œ์Šคํ…œ ์„ค๋ช…

๋Œ€๋ถ€๋ถ„์˜ "AI ์—์ด์ „ํŠธ"๋Š” ๋‹จ์ˆœํ•œ LLM ๋ž˜ํผ์ž…๋‹ˆ๋‹ค. ์ด ์‹œ์Šคํ…œ์€ ๋‹ค๋ฆ…๋‹ˆ๋‹ค โ€” ์Šค์Šค๋กœ ๊ณ„ํšํ•˜๊ณ , ํ‰๊ฐ€ํ•˜๊ณ , ํ•™์Šตํ•ฉ๋‹ˆ๋‹ค.

๊ธฐ์กด ๋ฐฉ์‹:   ์‚ฌ์šฉ์ž โ†’ ํ”„๋กฌํ”„ํŠธ โ†’ LLM โ†’ ์ถœ๋ ฅ (์›์ƒท)

์ด ์‹œ์Šคํ…œ:   ์‚ฌ์šฉ์ž ์ž…๋ ฅ โ†’ LLM์ด ์ ํ•ฉํ•œ ์—์ด์ „ํŠธ ๋ผ์šฐํŒ… โ†’ MCP ๋„๊ตฌ๋กœ ๋ฉ€ํ‹ฐ ํ”Œ๋žซํผ ์ˆ˜์ง‘
             โ†’ LLM์ด ๋ถ„์„ โ†’ LLM์ด ํ’ˆ์งˆ ์ž์ฒด ํ‰๊ฐ€(critic) โ†’ ๋ฏธ๋‹ฌ ์‹œ ๋ณด๊ฐ•(refine, ์ตœ๋Œ€ 3ํšŒ)
             โ†’ ๊ณผ๊ฑฐ ๋ถ„์„ ๋ฉ”๋ชจ๋ฆฌ์—์„œ ํ•™์Šต โ†’ ๋ฆฌํฌํŠธ + ํ›„์† ์งˆ๋ฌธ ์ œ์•ˆ

Plan โ†’ Execute โ†’ Evaluate โ†’ Refine ์ž์œจ ๋ฃจํ”„๊ฐ€ ํ•ต์‹ฌ์ž…๋‹ˆ๋‹ค โ€” LLM์ด ๊ฒฐ๊ณผ ํ’ˆ์งˆ์„ 4์ฐจ์›์œผ๋กœ ์ž์ฒด ํ‰๊ฐ€ํ•˜๊ณ , ๊ธฐ์ค€ ๋ฏธ๋‹ฌ ์‹œ ์Šค์Šค๋กœ ๋ณด๊ฐ•ํ•˜๋ฉฐ, ๊ณผ๊ฑฐ ๋ถ„์„์—์„œ ํ•™์Šตํ•ฉ๋‹ˆ๋‹ค. ํฌ๋ฆฌ์—์ดํ„ฐ URL์„ ์ž…๋ ฅํ•˜๋ฉด ์ฑ„๋„ DNA ๋ถ„์„์œผ๋กœ ์ž๋™ ๋ถ„๊ธฐํ•ฉ๋‹ˆ๋‹ค.


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

์‚ฌ์šฉ์ž ์ž…๋ ฅ (ํ‚ค์›Œ๋“œ or @์ฑ„๋„ํ•ธ๋“ค / youtube.com/... )
    โ”‚
    โ”œโ”€โ”€ [ํŠธ๋ Œ๋“œ ์ฟผ๋ฆฌ] โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
    โ”‚                                                  โ”‚
    โ”‚   [ํฌ๋ฆฌ์—์ดํ„ฐ URL ๊ฐ์ง€(CREATOR_URL_RE) โ†’ ๋ถ„๊ธฐ]    โ”‚
    โ–ผ                                                  โ–ผ
FastAPI(:8000) โ”€โ”€ SSE ์ŠคํŠธ๋ฆฌ๋ฐ โ”€โ”€โ–บ React(:5173) โ”€โ”€ Creator DNA Card
    โ”‚                                                  โ–ฒ
    โ–ผ                                                  โ”‚
3-Gear ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ดํ„ฐ (LangGraph)                       โ”‚
  Gear 1 route_request โ†’ Gear 2 plan_workflow โ†’ Gear 3 execute
    โ”œโ”€โ”€ news_trend_agent   โ†’ Brave Search โ†’ ๋‰ด์Šคยท์ปค๋ฎค๋‹ˆํ‹ฐ
    โ”œโ”€โ”€ viral_video_agent  โ†’ Brave Search โ†’ YouTubeยทTikTok
    โ””โ”€โ”€ social_trend_agent โ†’ Brave Search โ†’ XยทInstagram
          โ”‚
          โ–ผ  ๊ฐ ์—์ด์ „ํŠธ StateGraph:
   router โ†’ collect โ†’ normalize โ†’ analyze โ†’ summarize
                                    โ†’ critic โ‡„ refine (์ตœ๋Œ€ 3ํšŒ, 4์ฐจ์› ํ’ˆ์งˆ ๊ฒŒ์ดํŠธ)
                                    โ†’ report โ†’ notify
          โ”‚
          โ”œโ”€โ”€ Creator Intelligence (/api/creator/analyze)
          โ”‚     YouTube Data API v3 โ†’ Brave fallback โ†’ LLM DNA ๋ถ„์„ โ”€โ”€โ”˜
          โ”‚     โ†’ top_topics / content_pillars / ContentDraft ร—3
          โ”‚
          โ”œโ”€โ”€ Competitor Radar (/api/radar)  โ€” ํ‚ค์›Œ๋“œ ๋ชจ๋‹ˆํ„ฐ(์ตœ๋Œ€ 5) + ๋ณ€ํ™” ๊ฐ์ง€ ์•Œ๋ฆผ
          โ”œโ”€โ”€ Signal Archive (/api/signal-archive) โ€” ํ† ํ”ฝ ์ง„ํ™”ยทํฌ๋กœ์Šค ์‹ ์‹œ์‚ฌ์ด์ฆˆยท์ฃผ๊ฐ„ ๋‹ค์ด์ œ์ŠคํŠธ
          โ””โ”€โ”€ ์ผ์ผ ์Šค์ผ€์ค„๋Ÿฌ (src/core/scheduler.py) โ€” ์ธ๊ธฐ ๊ฒ€์ƒ‰์–ด ์ž๋™ ๋ถ„์„ โ†’ Slack
          โ”‚
    โ”Œโ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
    โ–ผ                    โ–ผ
Supabase PostgreSQL    Redis(:6380)        Prometheus(:9091) โ† /metrics
(insights, agent_memory,  (SSE ํžˆ์Šคํ† ๋ฆฌ,    AgentTracer: ๋…ธ๋“œ๋ณ„ ์‹คํ–‰ ์ถ”์ 
 query_logs, creators)     rate limit)

์ž๊ธฐ๊ฐœ์„  ๋ฃจํ”„ (Self-Critique)

ํ•ต์‹ฌ ํ˜์‹ : LLM์ด ์ž์‹ ์˜ ๋ถ„์„ ํ’ˆ์งˆ์„ ํ‰๊ฐ€ํ•˜๊ณ , ๊ธฐ์ค€ ๋ฏธ๋‹ฌ ์‹œ ์Šค์Šค๋กœ ๋ณด๊ฐ•ํ•ฉ๋‹ˆ๋‹ค.

summarize โ†’ critic (4์ฐจ์› LLM ํ’ˆ์งˆ ํ‰๊ฐ€) โ†’ score < 0.6 ? โ†’ refine โ†’ critic (์žฌํ‰๊ฐ€)
                                          score โ‰ฅ 0.6 ? โ†’ report (๋ณด๊ณ ์„œ ์ƒ์„ฑ)
                                          ์ตœ๋Œ€ 3ํšŒ ๋ฐ˜๋ณต

4์ฐจ์› ํ’ˆ์งˆ ํ‰๊ฐ€: ์ปค๋ฒ„๋ฆฌ์ง€ ยท ์‚ฌ์‹ค ์ •ํ™•์„ฑ ยท ์‹คํ–‰ ๊ฐ€๋Šฅ์„ฑ ยท ๊ท ํ˜•/ํŽธํ–ฅ

๋ฆด๋ฆฌ์Šค ํƒ€์ž„๋ผ์ธ

๋ฒ„์ „ ๋‚ ์งœ ์ฝ”๋“œ๋„ค์ž„ ํ•ต์‹ฌ ๊ธฐ์ˆ  ๊ณผ์ œ
v1.0.0 2026-03-31 Initial Release LangGraph 3-์—์ด์ „ํŠธ, Brave Search, SSE ์ŠคํŠธ๋ฆฌ๋ฐ
v1.1.0 2026-04-05 Light & Modes quick/standard/deep ๋ชจ๋“œ ๋ถ„๊ธฐ, Agent Collaboration ์‹œ๊ฐํ™”
v1.2.0 2026-04-10 Harness & Agentic AgenticToolLoop, SelfEvaluator, ์„ฑ๋Šฅ 50โ€“60%โ†‘
v1.3.0 2026-05-27 Creator Intelligence Creator DNA ๋ถ„์„, HMAC stateless OAuth, SOTA 2026 ๊ฐฑ์‹ 

๐Ÿ’ป Tech Stack

Agentic AI

LangGraph LangChain MCP Claude Code

LLM APIs

Anthropic OpenAI Google Gemini Meta Llama

Backend

Python FastAPI Pydantic HTTPX JWT

Frontend

TypeScript React Vite Tailwind CSS TanStack Query

Data & Storage

PostgreSQL SQLAlchemy Redis Pinecone

Observability & DevOps

Prometheus Langfuse GitHub Actions Docker Vercel

Cloud & Testing

Google Cloud Microsoft Azure pytest Ruff Pyright


Pinned Loading

  1. trace-to-fix-mcp trace-to-fix-mcp Public

    MCP server that turns Langfuse traces into actionable fix plans and GitHub issue drafts

    TypeScript

  2. opencode opencode Public

    Forked from anomalyco/opencode

    The open source coding agent.

    TypeScript

  3. SkyRL SkyRL Public

    Forked from NovaSky-AI/SkyRL

    SkyRL: A Modular Full-stack RL Library for LLMs

    Python

  4. StreamSonic-SeochoAI StreamSonic-SeochoAI Public

    Jupyter Notebook 1

  5. KDTAI-A3/kr-img2latex KDTAI-A3/kr-img2latex Public

    Extract text with LaTeX from image in English and Korean Using DONUT, BERT and ChatGPT.

    Jupyter Notebook 8 5