# Feishu File Upload & Send (Python) Minimal self-contained Python pattern for uploading a file to Feishu and sending it to a user. Works on Termux/Android with only Python stdlib (no lark CLI needed). ## Pattern ```python import json, urllib.request, os, uuid # 1. Get token from ~/.hermes/.env secret = None with open(os.path.expanduser("~/.hermes/.env")) as f: for line in f: if "FEISHU_APP_SECRET" in line: secret = line.strip().split("=", 1)[1].strip('"').strip("'") td = json.dumps({"app_id":"cli_a91b01debab81cd1","app_secret":secret}).encode() r = urllib.request.Request( "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal", data=td, headers={"Content-Type":"application/json"}, method="POST") with urllib.request.urlopen(r, timeout=15) as resp: token = json.loads(resp.read())["tenant_access_token"] # 2. Upload file bound = "----FB" + uuid.uuid4().hex[:16] fp = "/path/to/file.tar.gz" fn = "file.tar.gz" with open(fp, "rb") as f: fd = f.read() body = ( f"--{bound}\r\nContent-Disposition: form-data; name=\"file_name\"\r\n\r\n{fn}\r\n" f"--{bound}\r\nContent-Disposition: form-data; name=\"file_type\"\r\n\r\nstream\r\n" f"--{bound}\r\nContent-Disposition: form-data; name=\"file\"; filename=\"{fn}\"\r\n" f"Content-Type: application/octet-stream\r\n\r\n" ).encode() + fd + f"\r\n--{bound}--\r\n".encode() r = urllib.request.Request( "https://open.feishu.cn/open-apis/im/v1/files", data=body, headers={ "Authorization": f"Bearer {token}", "Content-Type": f"multipart/form-data; boundary={bound}" }, method="POST") with urllib.request.urlopen(r, timeout=60) as resp: file_key = json.loads(resp.read())["data"]["file_key"] # 3. Send to user (default: bo) RECEIVE_ID = "ou_e8e457355c6cc3c85057377c99091be0" # bo RECEIVE_TYPE = "open_id" send_data = json.dumps({ "receive_id": RECEIVE_ID, "msg_type": "file", "content": json.dumps({"file_key": file_key}) }).encode() r = urllib.request.Request( f"https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type={RECEIVE_TYPE}", data=send_data, headers={ "Authorization": f"Bearer {token}", "Content-Type": "application/json" }, method="POST") with urllib.request.urlopen(r, timeout=15) as resp: result = json.loads(resp.read()) print(f"code={result.get('code')} msg={result.get('msg')}") ``` ## Pitfalls - **write_file damages token variables**: Hermes content filtering mangles `TOKEN=...` patterns. Use `terminal` with `cat << 'PYEOF'` heredoc instead of `write_file` for scripts containing auth tokens. - **receive_id_type matters**: For users use `open_id`, for chats use `chat_id`. Wrong type → 400. - **upload timeout**: Large files (>10MB) need timeout=120 on upload. - **Don't use upload_and_send.py for files**: That script defaults to `open_id` type. When sending to chat, the `receive_id_type` must be `chat_id`. Use the raw API pattern above.