vibe

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 27 Open GitHub ↗

No description available.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ResearchOS Vibe

## English

ResearchOS Vibe is the public-facing web experience for ResearchOS and AI
Institute. It presents AI-assisted research as an investable, inspectable, and
repeatable operating system: human researchers define questions and judgment
standards; AI analysts continuously gather evidence, produce research outputs,
track thesis changes, and convert dense report graphs into reader-friendly
decision support.

The site is designed for investors, founders, operators, and research leaders
who need more than isolated reports. It shows how an AI research organization
can turn daily market information, analyst handoffs, research debates,
mailbox signals, deep research, and recap dashboards into a living knowledge
product.

Vibe is not the private research engine itself. It is the static publishing
layer: a business-facing site and investment portal that exposes sanitized AI
Institute outputs without shipping secrets or local source data.

Live site: https://vibe-alpha-three.vercel.app/

### AI Institute Narrative

AI Institute began with a product question: what if an AI research institute
could run like a real one? Not as a chatbot, not as a one-shot report generator,
but as a research organization with roles, routines, memory, internal
coordination, editorial judgment, and a publishable research record.

The build story matters because it mirrors the product thesis. The first
versions started as natural-language direction and grew into a working
institute: specialist analysts, scheduled daily work, mailbox handoffs,
research debates, research archives, quality checks, investor dashboards, and
public reports. The point was not to automate away the human researcher. The
point was to give the human researcher enough parallel research capacity,
context memory, and decision support to work at institutional scale.

In business terms, AI Institute behaves like a digital newsroom crossed with an
investment research desk. AI analysts scan markets, read source material, draft
views, challenge each other, hand off open questions, and preserve how a thesis
changes over time. The human researcher remains the editor-in-chief and
investment committee: selecting the questions, judging materiality, managing
risk, and deciding what should be acted on.

### Product Positioning

AI Institute is a multi-agent research workflow for financial and strategic
decision-making. Its core value is not content automation. It is research
operating leverage: a way to keep many analytical lines moving in parallel
while retaining source context, thesis lineage, and recap discipline.

The operating thesis is simple:

- Human researchers define the agenda, judgment standard, and final decision.
- AI analysts provide parallel coverage, first drafts, challenges, and
  continuous monitoring.
- Every useful result should keep its source relationships, not collapse into a
  context-free summary.
- Good research improves through recaps: past views need to be compared with
  later evidence and market performance.

Vibe turns that workflow into a usable product surface:

- A public introduction to ResearchOS and AI Institute.
- A 100-day temporal research atlas with a synchronized daily cursor, 3D
  thesis/lane/stock universe, research activity river, and expandable episode
  library.
- A reader-first investment portal for morning briefs, weekly positioning,
  human-readable memos, research-chain signals, and risk alerts.
- A bounded public research workspace that compresses the published corpus into
  12 current focus theses, preserves two dissent safeguards, and connects every
  item to its lane, stocks, shadow odds, confirmations, falsifiers, and source
  reports. It also retains a bounded published-snapshot history, shows daily
  entrants/exits/movers, previews source reports, separates supporting and
  challenging evidence, calculates browser-local portfolio impact, and keeps
  browser-local saved views and decision notes. This is an analysis and
  presentation view, not a research-production queue or a representation of
  hidden model state.
- A durable weekly investment report with deterministic calls, thesis/lane/
  stock reconciliation, two-sided evidence, next-week triggers, source
  previews, publication audit, and stable ISO-week edition routes. Rolling
  daily refreshes are deterministic; the weekly close can use a strictly
  grounded structured editor without allowing it to rewrite actions or IDs.
- Individual thesis, lane, and stock pages connected to a browser-local
  portfolio tracker.
- A 5/20/60-day shadow oddsboard that turns theses into falsifiable contracts,
  lanes into member-implied indices, and stocks into linked research-exposure
  surfaces. Market-implied odds, EV, Kelly sizing, and calibration remain
  disabled until the required price and settlement inputs exist.
- A timeline tracker that shows how briefs, reports, recaps, and living theses
  evolve over time.
- A searchable report library for AI analyst outputs.
- Deep research pages that retain source context and thesis lineage.
- Critical recap dashboards that compare past views with later evidence and
  market performance.
- Interactive presentation pages for business communication and handover.

### Business Use Cases

| Use case | What Vibe provides |
| --- | --- |
| Investment research | Daily brief dashboards, thesis trackers, analyst reports, deep research pages |
| Research operations | Evidence provenance, analyst handoffs, change radar, recap dashboards |
| Executive communication | Bilingual narratives, presentation routes, visual research summaries |
| Product demonstration | A live static site showing how AI research can become a decision-support product |
| Handover and continuity | Stable routes, generated contracts, and repeatable publishing workflows |

### Key Public Routes

| Route | Business purpose |
| --- | --- |
| `/` | ResearchOS and AI Institute landing experience |
| `/100-days/` | Interactive 100-day AI Institute timeline, 3D research atlas, episode library, and public scorecard |
| `/investor/` | Reader-first AI Institute investment portal |
| `/investor/daily/` | Latest daily morning brief dashboard |
| `/investor/workspace/` | Admin-gated change ledger, focus board, evidence split, portfolio impact, source previews, and interactive thesis-to-lane/stock/report map |
| `/investor/panorama/` | Admin-gated evidence-led weekly report: calls, deltas, positioning, tensions, triggers, source ledger, audit, and Word/PDF exports |
| `/investor/panorama/[ISO-WEEK]/` | Admin-gated durable weekly edition with stable source, evidence, JSON, Word, and PDF links |
| `/investor/research-network/` | Thesis, lane, stock, evidence, and recap network |
| `/investor/odds/` | Admin-gated shadow thesis contracts, lane-index term structures, and stock-linked odds surfaces |
| `/investor/theses/[id]/` | Individual living-thesis timeline and evidence page |
| `/investor/lanes/[slug]/` | Individual investable-lane page |
| `/investor/stocks/[ticker]/` | Individual stock or ETF research-exposure page |
| `/investor/portfolio/` | Browser-local thesis portfolio and risk-budget tracker |
| `/investor/timeline/` | Clickable timeline for briefs, reports, recaps, and thesis updates |
| `/investor/reports/[slug]/` | AI analyst report pages and reader reports |
| `/investor/deep-research/[slug]/` | Long-form deep research |
| `/investor/recaps/` | Critical recap dashboards |
| `/investor/console/` | Advanced full-corpus research console |
| `/graph/` | Research graph and map-style exploration |
| `/presentations/ai-human-research/` | Interactive presentation: AI working in parallel with human researchers |
| `/blog/` | Public articles, project narratives, and generated public posts |

### Operating Model

Vibe is a standalone Astro static site. It can be deployed independently on
Vercel or any static host. Operational data pipelines, private source material,
and API keys are managed separately from this public repository. Vercel uses
one runtime-only secret, `VIBE_ADMIN_TOKEN`, to gate the odds, workspace, and
weekly-research surfaces; it is never exposed through a `PUBLIC_*` variable.

The public repository contains only sanitized generated artifacts:

```text
src/generated/investor/
src/generated/hundred-days/
public/investor-assets/
public/investor-data/
public/investor-downloads/
public/hundred-days/
```

Private source data, API keys, and raw AI Institute outputs are not part of this
public repository.

### Admin Route Protection

Vercel Routing Middleware protects these deployed paths:

- `/investor/odds/`
- `/investor/workspace/`
- `/investor/panorama/` and all weekly edition routes
- `/investor-data/odds-board.json`
- `/investor-data/research-workspace.json`
- `/investor-data/weekly-report.json`
- `/investor-data/weekly-report-index.json`
- `/investor-data/weekly/*`
- `/investor-downloads/weekly/*` for matching Word and PDF editions

Set `VIBE_ADMIN_TOKEN` in **Vercel → Project Settings → Environment
Variables** for Production and Preview, then redeploy. Use a randomly generated
value of at least 32 characters.

Browser access uses HTTP Basic Auth:

- Username: `admin`
- Password: the value of `VIBE_ADMIN_TOKEN`

API clients can use either:

```bash
curl -H "Authorization: Bearer $VIBE_ADMIN_TOKEN" \
  https://vibe-alpha-three.vercel.app/investor-data/odds-board.json

curl -H "X-Admin-Token: $VIBE_ADMIN_TOKEN" \
  https://vibe-alpha-three.vercel.app/investor-data/research-workspace.json

curl -H "Authorization: Bearer $VIBE_ADMIN_TOKEN" \
  https://vibe-alpha-three.vercel.app/investor-downloads/weekly/2026-W28/AI-Institute-Weekly-Report-2026-W28-zh.pdf
```

The middleware fails closed with `503` when the variable is missing and returns
`401` for invalid credentials. Run `npm run test:admin-gate` to verify these
rules locally. `astro dev` does not emulate Vercel Routing Middleware.

Important boundary: this is HTTPS transport protection plus server-side route
access control. It is not encryption of files committed to GitHub. Because this
repository is public and some odds-derived summaries also appear on other
public investor pages, confidential source material must still never enter
these contracts. True artifact secrecy would require moving the protected
contracts to a private server-side store and removing all public generated
copies and derived views.

## 简体中文

ResearchOS Vibe 是 ResearchOS 与 AI Institute 的公开网站和投资研究展示台。它展示的不是单篇
AI 报告，而是一套可运行、可追溯、可复盘的 AI 研究操作系统：人类研究员负责提出问题、设定判断标准和做最终决策；AI
分析师持续收集证据、生成研究、跟踪观点变化，并把复杂的内部报告关系重组为更适合人阅读和决策的内容。

这个网站面向投资人、创业者、经营者和研究负责人。它回答一个核心问题：当 AI 不再只是聊天工具，而是可以在合适算力、环境和工作流中持续演化的研究伙伴时，金融投资和战略研究应该如何组织？

Vibe 不是私有研究引擎本身，而是公开的静态发布层。它把 AI Institute 中已经清洗过、适合公开展示的研究成果发布出来，同时避免把密钥或本地数据源放入静态网站仓库。

线上站点：https://vibe-alpha-three.vercel.app/

### AI Institute 的建设故事

AI Institute 的起点不是“让 AI 写一篇报告”，而是一个更像产品命题的问题：能不能让一座 AI
研究院像真实机构一样运转？它不是通用聊天机器人，也不是一次性报告生成器，而是一套有角色分工、日常节奏、机构记忆、内部协作、编辑判断和可发布研究记录的工作系统。

这个建设故事重要，是因为它本身就对应了产品主张。最初的版本从自然语言指令开始，逐步长成一个可以工作的研究院：专业分析师、每日任务、邮箱交接、研究讨论、研究档案、质量检查、投资看板和公开报告。目标不是把人类研究员替代掉，而是给人类研究员提供足够的并行研究能力、上下文记忆和决策支持，让一个人也能以接近机构化的方式组织研究。

从业务角度看，AI Institute 更像一间数字新闻编辑部加投资研究部。AI 分析师负责扫描市场、阅读材料、形成初稿、互相挑战、交接开放问题，并记录一个观点如何随着证据变化而演进。人类研究员仍然是总编辑和投委会：选择问题、判断重要性、管理风险，并决定哪些结论真正值得行动。

### 产品定位

AI Institute 是一个面向金融与战略决策的多智能体研究工作流。它的价值不是内容自动化，而是研究经营杠杆：让多条分析线索可以并行推进，同时保留来源关系、观点脉络和复盘纪律。

它的运行假设很清楚：

- 人类研究员负责设定议程、判断标准和最终决策。
- AI 分析师提供并行覆盖、初稿、反方挑战和持续监控。
- 有价值的输出必须保留来源关系，而不是压缩成脱离上下文的摘要。
- 好研究需要复盘：过去观点必须和后来的证据、价格表现、风险事件放在一起检验。

Vibe 把这套工作流呈现为一个可访问的产品界面：

- ResearchOS 与 AI Institute 的公开业务介绍。
- AI 研究院 100 天时间型研究图谱：包含可同步控制的每日时间游标、3D
  thesis/赛道/股票宇宙、研究活动河流和可持续扩展的研究事件库。
- 以每日晨会、周度定位和人类友好报告为起点的投资研究门户。
- 有限容量的公开研究注意力工作台：把已发布语料压缩为 12 条当前焦点，固定保留
  2 个反方槽位，并把每条焦点连接到赛道、股票、影子赔率、确认条件、证伪条件和公开源报告；
  同时保留有限的公开快照历史，展示每日进入、退出和变化，支持报告预览、支持/反向证据对照、
  浏览器本地组合影响、保存视图与决策记录。这个页面只负责分析与展示，不是研究生产队列，
  也不代表模型的隐藏内部状态。
- 可持久化的周度投资研究报告：由确定性代码生成操作结论、thesis/赛道/股票映射和环比变化，
  保留支持与反向证据、下周正负触发器、来源预览、发布审计与稳定的 ISO 周次页面；日常滚动更新
  不消耗模型调用，周度关闭时可以使用受严格证据约束的结构化编辑模型，但模型不能改写 action 或 ID。
- 从 thesis 到赛道、股票/ETF 研究节点，再到本地组合追踪的完整路径。
- 5/20/60 交易日影子赔率盘：把 thesis 改写成可证伪合约，把赛道组织成成员隐含指数，把股票展示为关联合约研究暴露；在真实价格、payoff 和结算样本接入前，不虚构市场赔率、EV 或 Kelly 仓位。
- 研究时间线追踪器，用于查看简报、报告、复盘和动态论点如何演进。
- AI 分析师报告库与人类友好的 reader report。
- 保留来源、证据和观点脉络的深度研究页面。
- 对关键主题进行时间线复盘和市场表现对照的 recap dashboard。
- 用于路演、汇报和交接的交互式展示页面。

### 业务场景

| 场景 | Vibe 提供的能力 |
| --- | --- |
| 投资研究 | 每日简报、市场信号、观点追踪、深度研究、风险提示 |
| 研究管理 | 证据来源、分析师交接、变化雷达、复盘仪表盘 |
| 管理层沟通 | 双语叙事、交互式演示、可视化研究摘要 |
| 产品展示 | 一个真实运行的 AI 研究产品前台 |
| 长期交接 | 稳定路由、生成数据契约、可重复发布流程 |

### 关键公开入口

| 路由 | 业务用途 |
| --- | --- |
| `/` | ResearchOS 与 AI Institute 首页 |
| `/100-days/` | AI 研究院 100 天交互时间线、3D 研究图谱、研究事件库与公开记分卡 |
| `/investor/` | 以读者和决策顺序为中心的 AI Institute 投资门户 |
| `/investor/daily/` | 最新晨会简报看板 |
| `/investor/workspace/` | 需要管理员令牌的变化账本、12 条有限焦点、证据分歧、组合影响、报告预览与交互关系图 |
| `/investor/panorama/` | 需要管理员令牌的证据型周报：操作结论、环比变化、仓位、分歧、触发器、来源账本、质量审计与 Word/PDF 导出 |
| `/investor/panorama/[ISO-WEEK]/` | 需要管理员令牌、可长期引用的周次版本，以及稳定的证据、JSON、Word 和 PDF 链接 |
| `/investor/research-network/` | Thesis、赛道、标的、证据与复盘网络 |
| `/investor/odds/` | 需要管理员令牌的主线合约、赛道指数期限结构与股票关联合约赔率 |
| `/investor/theses/[id]/` | 单条动态 thesis 的时间线和证据页 |
| `/investor/lanes/[slug]/` | 单条可投资赛道页 |
| `/investor/stocks/[ticker]/` | 单个股票或 ETF 的研究暴露页 |
| `/investor/portfolio/` | 浏览器本地 thesis 组合与风险预算追踪 |
| `/investor/timeline/` | 简报、报告、复盘和论点更新的可点击研究时间线 |
| `/investor/reports/[slug]/` | AI 分析师报告和 reader report |
| `/investor/deep-research/[slug]/` | 长篇深度研究 |
| `/investor/recaps/` | 关键主题复盘仪表盘 |
| `/investor/console/` | 面向完整报告语料的高级研究控制台 |
| `/graph/` | 研究图谱与地图式探索 |
| `/presentations/ai-human-research/` | 交互式中文演示：AI 如何与人类研究员并行 |
| `/blog/` | 公开文章、项目叙事和生成内容 |

### 运营边界

Vibe 是一个可独立部署的 Astro 静态网站。Vercel 构建不需要解密私有简报；运行时只读取 `VIBE_ADMIN_TOKEN`，用于保护赔率盘、Workspace 与周度研究发布面。运营数据管线、私有源材料和其他 API key 不属于这个公开仓库。

可以提交到 Vibe 的是已经清洗过的公开发布物：

```text
src/generated/investor/
src/generated/hundred-days/
public/investor-assets/
public/investor-data/
public/investor-downloads/
public/hundred-days/
```

私有数据、API key 和原始 AI Institute 输出不会进入这个公开仓库。

### 管理员路由保护

Vercel Routing Middleware 会保护：

- `/investor/odds/`
- `/investor/workspace/`
- `/investor/panorama/` 及所有周次版本
- `/investor-data/odds-board.json`
- `/investor-data/research-workspace.json`
- `/investor-data/weekly-report.json`
- `/investor-data/weekly-report-index.json`
- `/investor-data/weekly/*`
- `/investor-downloads/weekly/*` 下对应的 Word 与 PDF 文件

在 **Vercel → Project Settings → Environment Variables** 中为 Production
和 Preview 设置 `VIBE_ADMIN_TOKEN`，然后重新部署。建议使用至少 32 位的随机值，
且不要使用 `PUBLIC_` 前缀。

浏览器打开受保护页面时会出现 Basic Auth 登录框：

- 用户名：`admin`
- 密码：`VIBE_ADMIN_TOKEN` 的值

API 调用可以使用 `Authorization: Bearer` 或 `X-Admin-Token`。环境变量未配置时
中间件以 `503` 失败关闭；令牌错误时返回 `401`。本地可以运行
`npm run test:admin-gate` 验证规则，但 `astro dev` 不会模拟 Vercel 中间件。

必须明确：这提供的是 HTTPS 传输保护和服务器端路由访问控制，不会加密已经提交到
GitHub 的文件。由于当前仓库公开，且其他投资页面仍展示部分赔率派生摘要，任何真正的
机密材料仍不能进入这些公开契约。若要实现文件级保密，需要把契约迁移到私有服务端存储，
同时移除公开仓库中的明文副本和所有派生展示。

## Deployment

Production URL: https://vibe-alpha-three.vercel.app/

Use `vibe/` as the Vercel project root.

```text
Install command: npm install
Build command:   npm run build
Output:          dist
Node:            >=22.12.0
```

The production build is intentionally self-contained:

```bash
npm install
npm run test:admin-gate
npm run test:weekly
npm run dev
npm run build
```

## Technology

- Astro 6 static site framework
- Vanilla CSS with light/dark monochrome theme support
- Leaflet for map-oriented UI
- Three.js for the data-driven 100-day temporal research universe
- Static JSON contracts for investor data
- Generated chart, document, and image assets published as static files

vibe

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README