网有NETHAVE
AGENT SKILL

global-think-tank-analyst

Strategic-risk analysis skill for AI agents producing decision-ready memos on geopolitics, sanctions, trade, regulation, and strategic risk with explicit evidence boundaries, uncertainty, scenarios, actor incentives, trade-offs, and watch-next indicators. Use for a country risk brief, policy memo, sanctions or export-control exposure assessment, trade or regulatory implications memo, geopolitical scenario brief, strategic implications note for leadership, stakeholder and incentives analysis, a red-team challenge to an existing policy or risk view, or a decision briefing pack for founders, operators, investors, NGOs, compliance teams, policy teams, or leadership. Do not use for a simple news recap, encyclopedia-style overview, academic literature review, legal advice, intelligence-style certainty, decorative analysis, or unsupported quantitative forecasting.

适用职业律师与法务
使用场景Skill与智能体开发
License 许可
MIT
最近更新
2026-11-10
Stars
★ 7
Forks
2

01 前言 Front Matter

name
fastapi-uploadstream-binary-upload
description
Guide for handling HTTP uploads of binary data in FastAPI using fastapi_uploadstream. Use when users ask about how to upload raw http bodies to a fastapi app without multipart encoding. Describes StreamBody, UploadStream, content-type validation, chunked reads, or OpenAPI binary requestBody setup.
argument-hint
endpoint shape, accepted media types, and whether OpenAPI docs are needed
user-invocable
true

02 资源文件 290

03 SKILL.md 正文

FastAPI UploadStream Binary Uploads

Use this skill when you need to implement or explain raw HTTP binary uploads in FastAPI with fastapi_uploadstream.

What This Skill Covers

  • Installing and importing the library
  • Defining a streaming endpoint with StreamBody
  • Reading upload bytes safely with UploadStream
  • Restricting accepted Content-Type values
  • Publishing correct OpenAPI requestBody schema for binary bodies

Core Pattern

Use Annotated[UploadStream, StreamBody(...)] on a single endpoint parameter. Call install_uploadstream_openapi(app) once during app setup.

from typing import Annotated

from fastapi import FastAPI
from fastapi_uploadstream import StreamBody, UploadStream, install_uploadstream_openapi

import hashlib  # For demo only - not required.

app = FastAPI()
install_uploadstream_openapi(app)


@app.post("/upload")
async def upload_binary(
    body: Annotated[
        UploadStream,
        StreamBody(
            media_types=["application/octet-stream"],
            title="Binary upload",
            description="Raw binary request body to hash and return metadata",
        ),
    ],
):
    # Calculate SHA-256 hash of the uploaded data (for demo purposes)
    sha256 = hashlib.sha256()
    async for chunk in body.iter_chunks():
        sha256.update(chunk)
    return {
        "bytes": body.size,
        "content_type": body.content_type,
        "filename": body.filename,
        "size": body.size,
        "sha256": sha256.hexdigest(),
    }

Practical Guidance

  1. Prefer read(size) or iter_chunks() for large payloads.
  2. Set media_types to explicit values like application/octet-stream or image/*.
  3. Expect HTTP 415 when the request Content-Type is not allowed.
  4. Use only one StreamBody(...) per endpoint.
  5. Do not mix StreamBody with Body, Form, File, or UploadFile on the same endpoint.

Streaming Large Files

@app.post("/upload-large")
async def upload_large(
    body: Annotated[UploadStream, StreamBody(media_types=["application/octet-stream"])],
):
    total = 0
    async for chunk in body.iter_chunks(chunk_size=64 * 1024):
        total += len(chunk)
        # Process each chunk here.
    return {"bytes": total}

Ingesting whole file in memory (only small files)

You can also read the entire upload into memory for small files: But beware that this can lead to high memory usage for large uploads, and should be avoided.

@app.post("/upload-small")
async def upload_small(
    body: Annotated[UploadStream, StreamBody(media_types=["application/octet-stream"])],
):
    total = 0
    # watch out! this loads the entire request body!
    data = await body.read()
    total = len(data)
    return {"bytes": total}

Client Example

curl -X POST "http://localhost:8000/upload" \
  -H "content-type: application/octet-stream" \
  -H "x-filename: payload.bin" \
  --data-binary @payload.bin

Request Handling Notes

  • body.filename comes from the x-filename header when present.
  • body.size is derived from Content-Length when available.
  • body.content_type is the incoming request content type.
  • read(-1) reads all remaining bytes.

More Examples

See reference examples for common endpoint variants.

04 同仓库更多 Skills

vassiliylakhonin
vassiliylakhonin/global-think-tank-analyst

global-think-tank-analyst

Strategic-risk analysis skill for AI agents producing decision-ready memos on geopolitics, sanctions, trade, regulation, and strategic risk with explicit evidence boundaries, uncertainty, scenarios, actor incentives, trade-offs, and watch-next indicators. Use for a country risk brief, policy memo, sanctions or export-control exposure assessment, trade or regulatory implications memo, geopolitical scenario brief, strategic implications note for leadership, stakeholder and incentives analysis, a red-team challenge to an existing policy or risk view, or a decision briefing pack for founders, operators, investors, NGOs, compliance teams, policy teams, or leadership. Do not use for a simple news recap, encyclopedia-style overview, academic literature review, legal advice, intelligence-style certainty, decorative analysis, or unsupported quantitative forecasting.

律师与法务Skill与智能体开发
★ 7
vassiliylakhonin
vassiliylakhonin/global-think-tank-analyst

global-think-tank-analyst

暂无简介

Skill与智能体开发
★ 7
vassiliylakhonin
vassiliylakhonin/global-think-tank-analyst

policy-risk-memo-architect-codex

Codex-ready strategic-risk analysis skill for AI agents producing decision-ready memos on geopolitics, sanctions, trade, regulation, and strategic risk with explicit evidence boundaries, uncertainty, scenarios, actor incentives, trade-offs, and watch-next indicators. Use for a country risk brief, policy memo, sanctions or export-control exposure assessment, trade or regulatory implications memo, geopolitical scenario brief, strategic implications note for leadership, stakeholder and incentives analysis, a red-team challenge to an existing policy or risk view, or a decision briefing pack for founders, operators, investors, NGOs, compliance teams, policy teams, or leadership. Do not use for a simple news recap, encyclopedia-style overview, academic literature review, legal advice, intelligence-style certainty, decorative analysis, or unsupported quantitative forecasting.

律师与法务Skill与智能体开发
★ 7