zusik-py/zusik

zusik is an automated trading bot that runs around the clock, buying and selling Korean and US stocks and cryptocurrency through two Korean brokerage APIs, Korea Investment and Securities and Toss Securities. It is aimed at people who do not know Python: a single setup script installs everything, walks through entering API keys, and configures the bot without needing to edit code by hand. Trading decisions come from four AI analyst roles inside the bot, covering fundamentals, sentiment, quantitative signals, and an overall combined view, whose opinions are combined through a vote weighted by past performance. Stock selection can also run on Monte Carlo simulation, momentum, trend, or low volatility screening methods, and the bot adjusts its selection based on market conditions, such as favoring defensive low volatility stocks in a downturn or momentum stocks in a rally. A separate safety layer runs locally without calling any AI model, watching for sudden price drops, trailing stop losses, break even protection, and excessive trading, so protection still works even if the AI analysis is unavailable. The system tries to correct itself over time by running walk forward backtests over several years of daily price data to tune its exit parameters based on what actually worked. It also includes an inverse ETF hedge that only activates during sustained downturns rather than single day dips, closing the hedge position once it earns a small profit. Users can turn the Korean market, US market, or cryptocurrency trading on or off independently, and can choose to run without any AI provider at all, falling back to the local quantitative strategies only. Setup requires a brokerage account and API key from either supported broker, plus a computer that stays on continuously since the bot trades all day and night. Discord, Telegram, and Slack integrations let a user check status and send buy or sell commands from their phone. The README strongly recommends starting in the paper trading mode before using real money, and states plainly that the software is for education and research, with any financial losses from live trading being the user's own responsibility. It is licensed under MIT.