Rallies-CLI
扫码查看

一个由AI驱动的投资研究工具

Rallies-CLI

综合介绍

Rallies-CLI 是一款智能投资研究代理工具,它为熟悉终端操作的交易者和投资者设计,将人工智能的对话能力与实时金融数据相结合。你可以把它看作是专门为金融领域打造的ChatGPT,它接入了实时的市场数据、新闻资讯和全面的金融分析功能。与依赖过时数据的通用大语言模型不同,Rallies-CLI 基于实时更新的数据源,能够处理复杂的金融查询,并提供更准确的分析结果。例如,你可以用它查询某只股票当天的期权流数据,这是许多通用模型无法完成的任务。该工具通过简单的命令行界面提供服务,用户只需设置好API密钥便可启动,并通过自然语言进行提问,获取包括股票表现分析、市场情绪、技术指标解读和最新财经新闻在内的各类信息。

功能列表

  • 实时数据查询: 连接实时金融数据,提供最新的股票价格、交易量等市场信息。
  • 基本面分析: 分析公司的财务报表,查询近期业绩表现和关键财务指标。
  • 高级对比分析: 支持多支股票或资产在特定时间范围内的表现对比。
  • 技术分析: 提供常用技术指标(如均线、RSI、MACD)的查询和分析。
  • 市场新闻与事件: 获取最新的公司财报、美联储会议动态等影响市场的重大新闻。
  • 投资组合监控: 追踪用户投资组合中各项资产的动态。
  • 命令行交互: 提供一系列快捷命令,如/clear用于清空对话历史,/compact用于在保留上下文的同时压缩对话,以节省资源。
  • API密钥管理: 支持用户设置自己的OpenAI API密钥以及用于提升使用额度的Rallies.ai API密钥。

使用帮助

Rallies-CLI 是一款功能强大的命令行工具,让投资者可以直接在终端里利用AI进行金融研究。下面是详细的安装和使用流程,帮助你快速上手。

1. 环境要求

在开始安装之前,请确保你的系统满足以下条件:

  • Python版本: 3.8或更高版本。
  • API密钥: 一个有效的OpenAI API密钥(这是必须的)。
  • 终端: 建议使用支持彩色显示的终端,以获得更好的视觉体验。
  • 网络连接: 需要稳定的网络连接来获取实时数据。

2. 安装流程

目前,Rallies-CLI 支持从源代码安装。未来将支持通过PyPI直接安装。

从源代码安装:这是当前推荐的安装方式,可以确保你使用的是最新的版本。

第一步:克隆代码仓库打开你的终端,使用git命令将项目代码从GitHub克隆到本地。

git clone https://github.com/ralliesai/rallies-cli.git

第二步:进入项目目录克隆完成后,使用cd命令进入项目文件夹。

cd rallies-cli

第三步:安装依赖使用pip工具安装项目所需的依赖库。-e .参数表示以“可编辑”模式安装,这意味着你对源代码的任何修改都会立刻生效,方便开发和调试。

pip install -e .

安装过程会自动处理openairichrequests等依赖库。

(即将支持)通过PyPI安装:未来项目发布到PyPI后,你可以使用以下更简单的命令进行安装:

pip install rallies

3. 配置API密钥

Rallies-CLI 的核心功能依赖于OpenAI的GPT-4模型,因此必须配置OpenAI API密钥。

设置OpenAI API密钥:你需要在你的系统中设置一个环境变量OPENAI_API_KEY

在Linux或macOS系统中,可以使用export命令:

export OPENAI_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

注意: 请将 sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 替换成你自己的OpenAI API密钥。为了让这个环境变量永久生效,你可以将这行命令添加到你的shell配置文件中(如 ~/.bashrc~/.zshrc),然后重启终端或执行 source ~/.bashrc

设置Rallies.ai API密钥(可选):如果你需要更高的查询频率和使用额度,可以注册一个Rallies.ai的免费账户以获取专属API密钥。这个密钥不是必须的,但建议在高频使用时配置。

获取密钥后,启动工具,然后使用/key命令进行设置:

rallies > /key your-rallies-api-key```
### **4. 启动和使用**
完成安装和配置后,你就可以启动并开始使用了。
**启动应用:**
在终端里直接输入`rallies`命令并回车。
```bash
rallies

启动成功后,你会看到一个欢迎界面和输入提示符 >,这表示你可以开始提问了。

查询示例:你可以像聊天一样,用自然语言提出关于金融市场的问题。

  • 查询基本信息:
    > AAPL今天怎么样了?
    > 分析一下特斯拉最近的股价表现。
    > 给我看看科技板块今天涨幅最高的股票。
    
  • 进行高级分析:
    > 对比一下微软和谷歌在过去一个季度的表现。
    > 找一下技术形态上出现“杯柄形态”的股票。
    > 当前市场对加密货币的情绪是怎样的?
    
  • 获取技术指标:
    > 显示英伟达的各项技术指标。
    > 在标普500指数成分股里,有哪些股票处于超卖状态?
    
  • 了解新闻事件:
    > 这个星期有哪些公司会发布财报?
    > 美联储近期的会议对市场有什么影响?
    

5. 常用CLI命令

除了直接提问,Rallies-CLI还提供了一些内置命令来辅助使用。

  • /help: 显示所有可用的命令及其说明。
  • /key [API_KEY]: 设置你的Rallies.ai API密钥。
  • /feed: 浏览社区最近分享的高分问题,为你提供研究灵感。
  • /clear: 清空当前的对话历史,开始一个新的会话。
  • /compact: 在保留核心上下文的同时,压缩对话内容,有助于减少token消耗。
  • /exit 或 /quit: 退出应用程序。

6. 故障排除

  • 问题: "OpenAI API Key not found" (未找到OpenAI API密钥)
    • 解决方案: 确保你已经正确设置了OPENAI_API_KEY环境变量。可以输入echo $OPENAI_API_KEY来检查。
  • 问题: "Rate limit exceeded" (超出速率限制)
    • 解决方案: 这是因为短期内请求次数过多。可以尝试注册并使用Rallies.ai的API密钥以获得更高额度,或者使用/compact命令减少请求消耗。
  • 问题: "Import errors" (导入错误)
    • 解决方案: 可能是因为依赖没有正确安装。尝试强制更新rallies-cli: pip install --upgrade rallies

如果遇到其他问题,可以通过官方渠道获取帮助:

  • 电子邮件: support@rallies.ai
  • Discord: Rallies.ai Discord

应用场景

  1. 日常交易决策交易者可以在盘前、盘中或盘后,通过Rallies-CLI快速获取特定股票的实时数据、新闻和市场情绪分析,辅助自己做出更明智的交易决策。
  2. 投资组合分析投资者可以定期使用该工具审查自己的投资组合,分析各项资产的表现,并与市场基准进行比较,及时发现潜在的风险和机会。
  3. 行业与赛道研究当研究一个新的行业或赛道时,可以使用Rallies-CLI快速了解该领域的头部公司、市场动态和发展趋势,节省大量信息搜集的时间。
  4. 市场动态监控通过查询宏观经济事件(如利率变动、通胀数据)对市场的影响,用户可以更好地把握市场整体脉搏,调整自己的投资策略。

QA

  1. Rallies-CLI和通用的AI聊天工具(如ChatGPT)有什么核心区别?核心区别在于数据源。Rallies-CLI专门接入了实时更新的金融数据库,能够提供准确且及时的市场数据分析,例如查询某股票当天的期权流数据。而通用的AI工具通常依赖其训练数据截止日期前的旧信息或普通的网络搜索,无法满足金融领域对实时性的高要求。
  2. 使用此工具是否需要付费?该工具本身是开源免费的,但它需要一个OpenAI API密钥才能运行,而调用OpenAI的模型接口会产生费用。为了支持更高频的使用,用户还可以选择注册Rallies.ai的账户,获取免费或付费的更高速率API密钥。
  3. 这个工具提供的是投资建议吗?不。根据官方声明,Rallies-CLI是一个纯粹用于教育和研究目的的工具,它提供的信息不构成任何投资建议或财务指导。所有投资决策都应在咨询合格的金融顾问后做出。
  4. 我的API密钥安全吗?API密钥存储在你的本地环境变量中,工具在运行时会读取该变量。请确保你的本地环境是安全的,不要将你的密钥泄露给他人或提交到公开的代码仓库中。
微信微博Email复制链接