> ## Documentation Index > Fetch the complete documentation index at: https://docs.topk.io/llms.txt > Use this file to discover all available pages before exploring further. # Quickstart > Ingest your first document and ask a question. **Prerequisites** * TopK account ([Sign up here](https://console.topk.io/login)) * TopK API key ([Get API key here](https://console.topk.io/api-key)) ```bash theme={null} brew tap topk-io/topk brew install topk ``` If you don't have Homebrew installed, you can install it [here](https://brew.sh). ```bash theme={null} topk login ``` This command prompts you to either create a new API key or set an existing one. You can also skip the `topk login` command and authenticate by providing your API key via the `TOPK_API_KEY` environment variable: ```bash theme={null} export TOPK_API_KEY="your-api-key" ``` A dataset is a named container for your documents. To create a dataset, run the following command: ```bash theme={null} topk dataset create quickstart --region aws-us-east-1-elastica ``` The `--region` flag determines where your data is stored. See [available regions](/regions). Upload a file to your dataset: Download a sample PDF financial report: ```bash theme={null} curl -L https://topk-docs.s3.us-east-2.amazonaws.com/bank_of_america_2024.pdf -o report.pdf ``` ```bash theme={null} topk upload ./report.pdf --dataset quickstart ``` ```bash theme={null} topk ask "What was the total net income of Bank of America in 2024?" -d quickstart ``` **Answer:** * Bank of America's total net income for 2024 was \$27,132 million (approximately \$27.1 billion). 1 2 3 4 5 6 * The 2024 net income represented an increase from the \$26.5 billion reported in 2023. 3 4 6 * The increase was driven by higher noninterest income, partially offset by a higher provision for credit losses and lower net interest income. 3 6 **Citations:**

1 Condensed Statement of Cash Flows showing net income of \$27,132m (2024) vs \$26,515m (2023)
bank\_of\_america\_2024.pdf p. 170
2 Consolidated Statement of Comprehensive Income: net income line item for 2024–2022
bank\_of\_america\_2024.pdf p. 92
3 Supporting figure from the filing (tabular financial excerpt)
boa-ask-ref-3-figure.jpg
4 Key performance indicators—selected annual financial data (including net income)
bank\_of\_america\_2024.pdf pp. 33–36
5 Segment results tying to total-corporation net income
bank\_of\_america\_2024.pdf pp. 166–168
6 Executive summary—summary income statement and balance sheet excerpts
bank\_of\_america\_2024.pdf pp. 29–30

```json theme={null} { "facts": [ { "fact": "Bank of America's total net income for the fiscal year 2024 was $27,132 million.", "ref_ids": ["1", "2", "3", "4", "5", "6"] }, { "fact": "The 2024 net income of $27.1 billion represented an increase from the $26.5 billion reported in 2023.", "ref_ids": ["3", "4", "6"] }, { "fact": "The increase was driven by higher noninterest income, partially offset by a higher provision for credit losses and lower net interest income.", "ref_ids": ["3", "6"] } ], "refs": { "1": { "doc_id": "bank-of-america-annual-report-2024", "doc_type": "application/pdf", "dataset": "quickstart", "content_id": "doc#bank-of-america-annual-report-2024#chunk#130", "doc_name": "report.pdf", "content": { "text": "## Condensed Statement of Cash Flows\n[row_1]; []=Net income; [2024]=27,132; [2023]=26,515; [2022]=27,528\n...", "doc_pages": [170] } }, "2": { "doc_id": "bank-of-america-annual-report-2024", "doc_type": "application/pdf", "dataset": "quickstart", "content_id": "doc#bank-of-america-annual-report-2024#chunk#428", "doc_name": "report.pdf", "content": { "text": "## Consolidated Statement of Comprehensive Income\n[row_0]; [Dollars in millions]=Net income; [2024]=27,132; [2023]=26,515; [2022]=27,528\n...", "doc_pages": [92] } }, "3": { "doc_id": "bank-of-america-annual-report-2024", "doc_type": "application/pdf", "dataset": "quickstart", "content_id": "doc#bank-of-america-annual-report-2024#image#92", "doc_name": "report.pdf", "content": { "mime_type": "image/jpeg", "data": "" } }, "4": { "doc_id": "bank-of-america-annual-report-2024", "doc_type": "application/pdf", "dataset": "quickstart", "content_id": "doc#bank-of-america-annual-report-2024#chunk#129", "doc_name": "report.pdf", "content": { "text": "## Key Performance Indicators\n[row_7]=Income statement; []=Net income; [2024]=27,132; [2023]=26,515\n...", "doc_pages": [33, 34, 35, 36] } }, "5": { "doc_id": "bank-of-america-annual-report-2024", "doc_type": "application/pdf", "dataset": "quickstart", "content_id": "doc#bank-of-america-annual-report-2024#chunk#854", "doc_name": "report.pdf", "content": { "text": "## Results of Business Segments\n[row_9]; [Item]=Net income; [Total Corporation (2) 2024]=27,132; [Total Corporation (2) 2023]=26,515\n...", "doc_pages": [166, 167, 168] } }, "6": { "doc_id": "bank-of-america-annual-report-2024", "doc_type": "application/pdf", "dataset": "quickstart", "content_id": "doc#bank-of-america-annual-report-2024#chunk#131", "doc_name": "report.pdf", "content": { "text": "## Executive Summary > Financial Highlights\n[row_7]=Net income; [2024]=27,132; [2023]=26,515\n...", "doc_pages": [29, 30] } } }, "confidence": 100.0 } ``` To learn more about how to use TopK CLI, see the [CLI documentation](/cli). ```bash pip theme={null} pip install topk-sdk ``` ```bash uv theme={null} uv add topk-sdk ``` Setup the TopK client with your API key and region. ```python Sync theme={null} import os from topk_sdk import Client client = Client( api_key=os.environ["TOPK_API_KEY"], region=os.environ.get("TOPK_REGION", "aws-us-east-1-elastica"), ) ``` ```python Async theme={null} import os from topk_sdk import AsyncClient client = AsyncClient( api_key=os.environ["TOPK_API_KEY"], region=os.environ.get("TOPK_REGION", "aws-us-east-1-elastica"), ) ``` See [available regions](/regions) for a full list of supported regions. ```python Sync theme={null} client.datasets().create("quickstart") ``` ```python Async theme={null} await client.datasets().create("quickstart") ``` Upload a file to your dataset by providing the document ID, the path to the file, and optional metadata: Download a sample PDF financial report: ```bash theme={null} curl -L https://topk-docs.s3.us-east-2.amazonaws.com/bank_of_america_2024.pdf -o report.pdf ``` ```python Sync theme={null} from pathlib import Path handle = client.dataset("quickstart").upsert_file( "bank-of-america-annual-report-2024", # document ID Path("./report.pdf"), # path to file { "ticker": "BAC", "doc_type": "annual_report", "fiscal_year": 2024, }, ) ``` ```python Async theme={null} from pathlib import Path handle = await client.dataset("quickstart").upsert_file( "bank-of-america-annual-report-2024", # document ID Path("./report.pdf"), # path to file { "ticker": "BAC", "doc_type": "annual_report", "fiscal_year": 2024, }, ) ``` After the file has been uploaded, wait for it to be processed: ```python Sync theme={null} client.dataset("quickstart").wait_for_handle(handle) ``` ```python Async theme={null} await client.dataset("quickstart").wait_for_handle(handle) ``` ```python Sync theme={null} for message in client.ask("What was the total net income of Bank of America in 2024?", ["quickstart"]): print(message) ``` ```python Async theme={null} async for message in client.ask("What was the total net income of Bank of America in 2024?", ["quickstart"]): print(message) ``` ```json theme={null} { "facts": [ { "fact": "Bank of America's total net income for the fiscal year 2024 was $27,132 million.", "ref_ids": ["1", "2", "3", "4", "5", "6"] }, { "fact": "The 2024 net income of $27.1 billion represented an increase from the $26.5 billion reported in 2023.", "ref_ids": ["3", "4", "6"] }, { "fact": "The increase in 2024 net income was driven by higher noninterest income, although this was partially offset by a higher provision for credit losses and lower net interest income.", "ref_ids": ["3", "6"] } ], "refs": { "1": { "doc_id": "bank-of-america-annual-report-2024", "doc_type": "application/pdf", "dataset": "quickstart", "content_id": "doc#bank-of-america-annual-report-2024#chunk#130", "doc_name": "report.pdf", "content": { "data": { "Chunk": { "text": "## Condensed Statement of Cash Flows\n[row_1]; []=Net income; [2024]=27,132; [2023]=26,515; [2022]=27,528\n...", "doc_pages": [170] } } } }, "2": { "doc_id": "bank-of-america-annual-report-2024", "doc_type": "application/pdf", "dataset": "quickstart", "content_id": "doc#bank-of-america-annual-report-2024#chunk#428", "doc_name": "report.pdf", "content": { "data": { "Chunk": { "text": "## Consolidated Statement of Comprehensive Income\n[row_0]; [Dollars in millions]=Net income; [2024]=27,132; [2023]=26,515; [2022]=27,528\n...", "doc_pages": [92] } } } }, "3": { "doc_id": "bank-of-america-annual-report-2024", "doc_type": "application/pdf", "dataset": "quickstart", "content_id": "doc#bank-of-america-annual-report-2024#image#92", "doc_name": "report.pdf", "content": { "data": { "Image": { "mime_type": "image/jpeg", "data": "" } } } }, "4": { "doc_id": "bank-of-america-annual-report-2024", "doc_type": "application/pdf", "dataset": "quickstart", "content_id": "doc#bank-of-america-annual-report-2024#chunk#129", "doc_name": "report.pdf", "content": { "data": { "Chunk": { "text": "## Key Performance Indicators\n[row_7]=Income statement; []=Net income; [2024]=27,132; [2023]=26,515\n...", "doc_pages": [33, 34, 35, 36] } } } }, "5": { "doc_id": "bank-of-america-annual-report-2024", "doc_type": "application/pdf", "dataset": "quickstart", "content_id": "doc#bank-of-america-annual-report-2024#chunk#854", "doc_name": "report.pdf", "content": { "data": { "Chunk": { "text": "## Results of Business Segments\n[row_9]; [Item]=Net income; [Total Corporation (2) 2024]=27,132; [Total Corporation (2) 2023]=26,515\n...", "doc_pages": [166, 167, 168] } } } }, "6": { "doc_id": "bank-of-america-annual-report-2024", "doc_type": "application/pdf", "dataset": "quickstart", "content_id": "doc#bank-of-america-annual-report-2024#chunk#131", "doc_name": "report.pdf", "content": { "data": { "Chunk": { "text": "## Executive Summary > Financial Highlights\n[row_7]=Net income; [2024]=27,132; [2023]=26,515\n...", "doc_pages": [29, 30] } } } } }, "confidence": 100.0 } ``` To learn more about how to use the Python SDK, see the [Python SDK documentation](/sdk/topk-py). ```bash npm theme={null} npm install topk-js ``` ```bash yarn theme={null} yarn add topk-js ``` ```bash pnpm theme={null} pnpm add topk-js ``` ```typescript theme={null} import { Client } from "topk-js"; const client = new Client({ apiKey: "your-api-key", region: "aws-us-east-1-elastica", }); ``` See [available regions](/regions) for a full list of supported regions. ```typescript theme={null} await client.datasets().create("quickstart"); ``` Download a sample PDF financial report: ```bash theme={null} curl -L https://topk-docs.s3.us-east-2.amazonaws.com/bank_of_america_2024.pdf -o report.pdf ``` ```typescript theme={null} const handle = await client.dataset("quickstart").upsertFile( "bank-of-america-annual-report-2024", // document ID { path: "./report.pdf" }, // path to file { ticker: "BAC", doc_type: "annual_report", fiscal_year: 2024, }, ); ``` Wait for the file to be processed: ```typescript theme={null} await client.dataset("quickstart").waitForHandle(handle); ``` ```typescript theme={null} for await (const message of client.ask("What was the total net income of Bank of America in 2024?", ["quickstart"])) { console.log(message); } ``` ```json theme={null} { "facts": [ { "fact": "Bank of America's total net income for the fiscal year 2024 was $27,132 million.", "refIds": ["1", "2", "3", "4", "5", "6"] }, { "fact": "The 2024 net income of $27.1 billion represented an increase from the $26.5 billion reported in 2023.", "refIds": ["3", "4", "6"] }, { "fact": "The increase in 2024 net income was driven by higher noninterest income, although this was partially offset by a higher provision for credit losses and lower net interest income.", "refIds": ["3", "6"] } ], "refs": { "1": { "docId": "bank-of-america-annual-report-2024", "docType": "application/pdf", "dataset": "quickstart", "contentId": "doc#bank-of-america-annual-report-2024#chunk#130", "docName": "report.pdf", "content": { "type": "chunk", "data": { "text": "## Condensed Statement of Cash Flows\n[row_1]; []=Net income; [2024]=27,132; [2023]=26,515; [2022]=27,528\n...", "docPages": [170] } } }, "2": { "docId": "bank-of-america-annual-report-2024", "docType": "application/pdf", "dataset": "quickstart", "contentId": "doc#bank-of-america-annual-report-2024#chunk#428", "docName": "report.pdf", "content": { "type": "chunk", "data": { "text": "## Consolidated Statement of Comprehensive Income\n[row_0]; [Dollars in millions]=Net income; [2024]=27,132; [2023]=26,515; [2022]=27,528\n...", "docPages": [92] } } }, "3": { "docId": "bank-of-america-annual-report-2024", "docType": "application/pdf", "dataset": "quickstart", "contentId": "doc#bank-of-america-annual-report-2024#image#92", "docName": "report.pdf", "content": { "type": "image", "data": { "mimeType": "image/jpeg", "data": "" } } }, "4": { "docId": "bank-of-america-annual-report-2024", "docType": "application/pdf", "dataset": "quickstart", "contentId": "doc#bank-of-america-annual-report-2024#chunk#129", "docName": "report.pdf", "content": { "type": "chunk", "data": { "text": "## Key Performance Indicators\n[row_7]=Income statement; []=Net income; [2024]=27,132; [2023]=26,515\n...", "docPages": [33, 34, 35, 36] } } }, "5": { "docId": "bank-of-america-annual-report-2024", "docType": "application/pdf", "dataset": "quickstart", "contentId": "doc#bank-of-america-annual-report-2024#chunk#854", "docName": "report.pdf", "content": { "type": "chunk", "data": { "text": "## Results of Business Segments\n[row_9]; [Item]=Net income; [Total Corporation (2) 2024]=27,132; [Total Corporation (2) 2023]=26,515\n...", "docPages": [166, 167, 168] } } }, "6": { "docId": "bank-of-america-annual-report-2024", "docType": "application/pdf", "dataset": "quickstart", "contentId": "doc#bank-of-america-annual-report-2024#chunk#131", "docName": "report.pdf", "content": { "type": "chunk", "data": { "text": "## Executive Summary > Financial Highlights\n[row_7]=Net income; [2024]=27,132; [2023]=26,515\n...", "docPages": [29, 30] } } } }, "confidence": 100.0 } ``` To learn more about how to use the JavaScript SDK, see the [JavaScript SDK documentation](/sdk/topk-js). Congratulations! You've just ingested your first document and asked a question. ### Next steps Learn how to upload your documents. Run an agentic query to get grounded answers with source citations. Find the most relevant passages in your documents. Explore topics more deeply with multi-step analysis and grounded citations.