bullarc (1d1fc5)

bullarc

Your terminal is now a trading desk.

牛市融合了价格技术指标、新闻情绪、社会速度、链上流量， 将鲸鱼警报和期权活动合并为单个买入/卖出/持有信号——供电 通过11个指标和人工智能驱动的信心评分。

快速开始

# Install
go install github.com/bullarc/bullarc/cmd/bullarc@latest

# Run the built-in demo (zero config, embedded data)
bullarc demo

没有API密钥，没有配置文件，没有数据下载。结果不到一秒钟。

它能做什么？

分析 --6个数据层，11个指标，1个复合信号

bullarc analyze --symbol AAPL --llm

反测试 --历史数据的回放策略

bullarc backtest --csv data.csv --indicators RSI_14,MACD_12_26_9,SuperTrend_7_3.0

纸张贸易 --使用真实市场数据、模拟货币自动执行

bullarc paper trade --symbol AAPL --confidence 70

AI审查 --Claude在20多次交易后分析您的交易模式

bullarc journal review

MCP服务器 --让Claude在Claude Desktop或Cursor中担任您的分析师

MASSIVE_API_KEY=xxx bullarc mcp install   # one-command Claude Code setup

特性

• 11技术指标：SMA、EMA、RSI、MACD、布林带、SuperTrend、随机、ATR、VWAP、OBV
• 多源信号融合：价格+新闻情绪+Reddit社交速度+链上加密流量+鲸鱼警报+期权活动
• 人工智能驱动的分析：LLM驱动的信号解释、市场机制检测、异常检测、投资组合相关性
• 回测：历史回放，模拟回报，最大回撤，胜率
• 纸上交易：通过Alpaca自动执行，具有可配置的置信阈值
• 行业杂志：记录每笔交易，通过过滤器查询，人工智能模式审查
• MCP服务器：克劳德桌面/光标集成的10个工具
• Go SDK：在您自己的应用程序中嵌入分析
• 零配置演示：嵌入示例数据，开箱即用

数据源

设置

# Store credentials once (optional — works without any keys via CSV mode)
bullarc configure --massive-key $MASSIVE_API_KEY
bullarc configure --alpaca-key $ALPACA_API_KEY --alpaca-secret $ALPACA_SECRET_KEY
bullarc configure --llm-key $ANTHROPIC_API_KEY

# Or just set env vars — bullarc auto-detects them
export MASSIVE_API_KEY=xxx        # Massive market data
export ALPACA_API_KEY=xxx         # Alpaca market data (alternative)
export ALPACA_SECRET_KEY=xxx
export ANTHROPIC_API_KEY=xxx      # LLM explanations (optional)

或者使用配置文件：

data_sources:
  default: massive
  massive:
    enabled: true
    api_key: "${MASSIVE_API_KEY}"

llm:
  provider: anthropic
  api_key: "${ANTHROPIC_API_KEY}"
  model: claude-opus-4-6

凭证解析顺序：标志>环境变量>密钥库(~/.config/bullarc/credentials)>配置文件。

命令行命令

MCP服务器

# One-command setup for Claude Code (auto-detects env vars)
MASSIVE_API_KEY=xxx bullarc mcp install

# Or start manually
bullarc mcp

install命令在Claude Code中全局注册bullarc——没有配置文件 需要。它检测 MASSIVE_API_KEY, ALPACA_API_KEY, ALPACA_SECRET_KEY，以及 ANTHROPIC_API_KEY 并将它们转发到MCP服务器。

通过JSON-RPC 2.0标准公开10个工具：

建筑

bullarc.go               # All interfaces and types. The API contract.
cmd/bullarc/             # CLI (cobra). Thin wrapper over the SDK.
internal/engine/         # Wires indicators, data sources, LLMs together.
internal/indicator/      # Pure computation. No I/O, no imports from other internals.
internal/datasource/     # Market data fetching. Implements DataSource interface.
internal/llm/            # LLM adapters. Implements LLMProvider interface.
internal/signal/         # Aggregates indicator outputs into Signal values.
internal/config/         # Config loading and credential storage.
internal/mcp/            # MCP server: JSON-RPC 2.0 over stdio.
internal/journal/        # Trade journal logging and querying.
pkg/sdk/                 # Public Go SDK. Wraps the engine behind a stable surface.
testutil/                # Shared test helpers.
testdata/                # CSV fixtures and reference values.

所有共享类型和接口都存在于根包中。内部包装 实现这些接口，但从不相互导入。仅 internal/engine 将它们连接在一起。

Go SDK

client := sdk.New(engine)

// One-shot analysis
result, err := client.Analyze(ctx, bullarc.AnalysisRequest{Symbol: "AAPL", UseLLM: true})

// Backtest
result, err := client.Backtest(ctx, bullarc.BacktestRequest{Symbol: "AAPL", Bars: bars})

// Stream signals (polling)
ch := client.StreamSymbols(ctx, []string{"AAPL", "MSFT"}, 5*time.Minute)
for sig := range ch {
    // sig.Type, sig.Confidence, sig.Symbol
}

// Push-based subscription
ch := client.Subscribe(ctx, bullarc.AnalysisRequest{Symbol: "AAPL"})

构建

make build       # Produces bin/bullarc
make test        # All tests with race detector
make check       # fmt + vet + test
make verify      # Build all + smoke tests
make lint        # golangci-lint
make demo        # Run the built-in demo
make demo-gif    # Generate demo.gif (requires VHS)

码头工人

docker run --rm \
  -e MASSIVE_API_KEY= \
  -e ANTHROPIC_API_KEY= \
  ghcr.io/bullarc/bullarc:latest analyze --symbol AAPL --llm

需求

• 转到1.22+
• 数据源和LLM提供程序的API密钥（可选-CSV模式在没有任何密钥的情况下工作）

许可证

麻省理工学院——见 许可证 了解详情。