alsk1992/CloddsBot

Clodds — AI‑powered trading terminal

What it is – Clodds는 명령줄과 WebChat이 결합된 자가 호스팅 애플리케이션으로, AI(Claude 기반)와 대화하여 수십 개의 예측 시장 플랫폼, 암호화폐 현물 시장, 레버리지 무기한 선물, 새로운 Solana 토큰 출시, 그리고 Bittensor 서브넷 채굴까지 가능하게 합니다. 모든 상호작용은 21개의 메시징 서비스(Telegram, Discord, Slack, WhatsApp, etc.) 또는 내장된 브라우저 UI를 통한 자연어 채팅으로 이루어집니다.

Key capabilities

• Multi‑market access – 10개의 예측 시장 플랫폼(Polymarket, Kalshi, Betfair …) 및 7개의 선물 거래소(Binance, Bybit, Hyperliquid, MEXC, Drift, Percolator, Lighter).
• Cross‑chain DeFi – Solana DEXs(Jupiter, Raydium, Orca, etc.) 및 EVM DEXs(Uniswap V3, 1inch, PancakeSwap, Virtuals)와 MEV 보호 기능.
• AI trading engine – Claude 기반 에이전트에 의해 실행되는 118개 이상의 사전 구축된 전략(momentum, mean‑reversion, DCA, arbitrage, whale‑tracking, copy‑trading). AI는 시맨틱 메모리(LanceDB + embeddings)를 유지하며 오래된 채팅 기록을 압축하여 절대 "잊어버리지" 않습니다.
• Risk & audit – 통합 리스크 엔진(VaR/CVaR, circuit‑breaker, Kelly sizing, daily loss caps), 암호화된 자격 증명 저장소, 신뢰도 보정 및 선택적 온체인 해시 앵커링이 포함된 전체 거래 원장.
• Automation & extensibility – 121개의 번들된 "기술"(lazy‑loaded)을 통해 웹 스크래핑, 코드 실행, SQL, 이메일, 웹훅 등의 도구를 제공합니다. cron job을 예약하거나, 봇을 트리거하거나, REST API를 호출하여 대화를 관리할 수 있습니다.
• Bittensor mining – 내장된 사이드카를 통해 동일한 인터페이스에서 직접 Bittensor 서브넷에서 TAO를 채굴할 수 있습니다.
• Token‑launch workflow – Meteora bonding curves를 통한 원클릭 Solana 토큰 생성, 안티 스나이퍼 보호 및 수수료 분할 기능 포함.
• Agent marketplace & forum – AI 전략을 사고팔 수 있는 Solana 기반 마켓플레이스 및 에이전트 토론 포럼.

How to get started

1. Install – 권장되는 방법은 최신 GitHub 릴리스를 가져오는 단일 npm 명령어입니다:

   npm install -g https://github.com/alsk1992/CloddsBot/releases/latest/download/clodds.tgz
   clodds onboard   # runs an interactive wizard
   

   위저드는 Anthropic (Claude) API 키, 거래소 API 키, 그리고 활성화할 메시징 채널을 묻습니다.
2. Run – 온보딩 후, 게이트웨이를 시작합니다:

   clodds start
   

   내장된 WebChat UI는 http://localhost:18789/webchat에서 사용할 수 있습니다.
3. Chat – 자연어를 사용하여 거래를 수행하거나, 차익 거래 기회를 묻거나, 토큰을 출시합니다. 예:
   • Buy 0.05 BTC on Polymarket, round ends in 15 min
   • Show me the best arbitrage between Binance and Bybit for ETH
   • Launch a new Solana token with a 5 % creator fee
4. CLI shortcuts – 유용한 명령은 다음과 같습니다:
   • clodds repl – 빠른 명령을 위한 대화형 REPL
   • clodds doctor – 시스템 진단
   • clodds ledger stats – 손익 및 신뢰도 통계 보기
   • clodds bittensor setup – Bittensor 채굴 설정

Architecture at a glance

• Gateway & UI layer – 21개의 메시징 어댑터와 WebChat UI를 처리하는 HTTP/WebSocket 서버.
• AI agents layer – 최대 8개의 LLM 제공업체로 구동되는 4개의 에이전트(Main, Trading, Research, Alerts); 121개의 기술 및 18개의 도구 통합; LanceDB에 저장된 시맨틱 메모리.
• Strategy & risk layer – 118개 이상의 전략, 리스크 엔진(VaR/CVaR, circuit‑breaker, Kelly sizing), 백테스팅 및 거래 원장.
• Execution layer – 예측 시장 API, Solana DEXs, EVM DEXs 및 선물 거래소로 연결되는 커넥터; 통합 주문 라우팅 및 스마트 라우팅 로직.
• Persistence – 로컬 상태를 위한 SQLite, 분석을 위한 PostgreSQL, 임베딩을 위한 LanceDB.

Who it’s for

• 코드를 작성하는 대신 대화형 인터페이스를 원하는 퀀트 중심 트레이더.
• 즉시 사용 가능한 멀티 마켓 커넥터가 필요한 AI 기반 트레이딩 봇 구축 개발자.
• 암호화폐와 전통적인 예측 시장 모두에서 차익 거래 또는 전략 아이디어를 테스트하는 데 관심이 있는 연구원.

Licensing & status

• MIT 라이선스 하에 오픈 소스.
• 바이너리 패키지로 출시됨; 저장소에는 소스, 문서 및 USER_GUIDE.md가 포함되어 있음.
• 원래 Colosseum Solana Agent Hackathon을 위해 12일 만에 구축됨; 현재 활발히 유지 관리 중임(README에 최신 릴리스 배지가 표시됨).

---

위의 모든 정보는 저장소의 README에서 직접 가져온 것이며, 추가적인 기능 추론은 포함되지 않았습니다.