tenk 0.1.2

Talk to SEC filings with AI

tenk

Talk to SEC filings with AI

Ask questions about 10-K and 10-Q filings, get answers with citations

What is tenk?

tenk lets you have a conversation with SEC filings. Instead of manually reading through hundreds of pages of 10-K and 10-Q reports, just ask questions in plain English and get answers with direct citations to the source.

Why not just use ChatGPT?

You could copy-paste filings into ChatGPT, but:

• 10-Ks are 100+ pages - you can't paste them all
• You definitely can't paste multiple filings to compare companies
• You'd have to manually find and download each filing first

tenk automates all of that. It fetches filings from SEC EDGAR, indexes them locally, and lets you query across multiple filings at once.

Features

• ✅ RAG over SEC filings with a local vector database (10-K, 10-Q)
• ✅ Auto-downloads filings from SEC EDGAR
• ✅ Citations with links to source documents
• ✅ Stock data via Yahoo Finance
• ✅ Web search for data not in filings
• ✅ Excel generation for tables and financial models
• ✅ Export answers to PDF, DOCX, or Excel
• ✅ Conversation memory with auto-summarization

Requirements

• Python 3.10+
• OpenAI API key (set OPENAI_API_KEY environment variable)

Installation

pip install tenk

Or from source:

git clone https://github.com/rallies-ai/tenk.git
cd tenk
pip install -e .

Usage

Interactive mode:

tenk

One-shot mode:

tenk "What are Apple's main risk factors?"

Examples

> What are NVIDIA's revenue segments?

> Compare AAPL and MSFT gross margins for 2024

> What does Tesla say about competition in their latest 10-K?

> Create an Excel file with Amazon's quarterly revenue for the past 2 years

How it works

1. Check available filings - Queries SEC EDGAR to see what's available
2. Download & index - Downloads filings and chunks them into a local vector database
3. Semantic search - Finds relevant passages using sentence-transformers
4. AI analysis - Generates answers with citations
5. Export - Optionally export to PDF, DOCX, or Excel

Configuration

Config file is at src/config.yaml:

model:
  name: gpt-5.2
  max_turns: 50

search:
  top_k: 10
  chunk_size: 3000
  chunk_overlap: 500

embeddings:
  model: all-MiniLM-L6-v2

edgar:
  identity: "Your Name [e-mail]"  # Required by SEC EDGAR

database:
  path: db/filings.db

exports:
  dir: exports

Note: SEC EDGAR requires a valid user-agent identity. Update the edgar.identity field with your name and email.

Data Storage

• Filings database: db/filings.db (DuckDB)
• Exports: exports/ directory

Both are created automatically in your current working directory.

License

Personal Use License - free for personal and non-commercial use. Commercial use prohibited. See LICENSE for details.

---

Built with ❤️ by Rallies.ai