huggingface / smolagents · 入門

這個 repository 的平台 metadata 把它描述為「🤗 smolagents: a barebones library for agents that think in code.」這段文字是專案自己的作者自述，不是分析器的發現。metadata 列出的主要語言是 Python，Python 有 988,225 個語言位元組，Makefile 則是 326 個。記錄的授權是 Apache-2.0。記錄到的最新 release 是 v1.26.0，於 2026-05-29 發布，這個 repository 在 2026-09-14 有 29,313 個 star。分析器的摘要算到 185 個被分析的檔案，圍繞 docs、examples、src 和 tests 組織，並回報有 28 個類測試檔案和 7,633 條靜態關係邊。

依賴記錄只來自 requirements 形式的清單檔；全部 43 筆記錄都是 runtime scope，並指向兩個來源檔：examples/async_agent/requirements.txt 和 examples/open_deep_research/requirements.txt。pyproject.toml 的依賴表沒有被解析，即使 pyproject.toml 本身被標為專案層級的重要檔案。async_agent 的清單檔提供四筆執行期記錄：smolagents、starlette、anyio 和 uvicorn，都沒有固定版本。open_deep_research 的清單檔提供其餘 39 筆執行期記錄，例如 anthropic >=0.37.1、openai >=1.52.2、torch >=2.2.2 和 transformers >=4.46.0。廣泛來看（只限於引用的記錄），這份清單涵蓋了網頁擷取（beautifulsoup4、markdownify）、文件處理（openpyxl、mammoth、pypdf、PyPDF2）、資料科學（numpy、pandas、scikit-learn、scipy）和模型相關套件（torch、torchvision、transformers），這暗示它是一個大量使用工具的研究範例。

分析資料列出十筆進入點記錄，其中八筆帶有 Python __main__ 守衛。這八個守衛中有六個只是呼叫一個 main() 函式，包括 src/smolagents/cli.py（它的守衛寫著 'if __name__ == "__main__":'），examples/open_deep_research/run.py 和 run_gaia.py 的守衛也是這樣。examples/open_deep_research/app.py 的守衛呼叫 demo.launch()；examples/smolagents_benchmark/run.py 的守衛則先解析參數、載入一個評估資料集，再依模型類型分支。另外兩筆記錄 examples/async_agent/main.py 和 examples/server/main.py，只是依檔名啟發式規則被標為可能可執行。列出的有界執行路徑只涵蓋兩個進入點：從 examples/async_agent/main.py 出發會到達 Route 和 Starlette，從 examples/open_deep_research/app.py 出發會到達 create_agent、GradioUI 和 demo.launch；每一條列出的路徑都停在未解析的邊界。摘要另外把 examples/structured_output_tool.py 稱為看起來的主要起點。超出這些記錄的執行時行為，這次靜態分析無法確定。

從專案層級的重要檔案開始：README.md、pyproject.toml 和 LICENSE。另有五個檔案因為可能是進入點而被標為重要：examples/structured_output_tool.py、src/smolagents/cli.py、src/smolagents/vision_web_browser.py、examples/open_deep_research/app.py 和 examples/open_deep_research/run.py。分析器關於學習路徑的教學陳述說：先從清單檔和重要符號開始，再追蹤有界執行路徑，並在改程式之前檢查未解析的邊界。它關於修改的陳述說：從 examples/async_agent/main.py 開始分析修改，並手動確認下游的影響。在 185 個被分析的檔案中，頂層目錄有 docs（81 個檔案）、examples（34）、src（21）和 tests（28），另有 .github（10）和 11 個根目錄層級的項目。摘要回報有 28 個類測試檔案，所以被分析的清單裡確實有一套測試。

這裡沒有驗證任何安裝、建置或執行指令；安裝／執行／建置的推論並不完整。分析器沒有解析 pyproject.toml 的依賴表。README 的擷取是逐行進行的，可能抓到程式碼行而不是說明文字，所以來自 README 的文字最多只算作者自述。這次分析只有靜態的部分：反射、動態 import、框架在執行期的接線和動態分派都沒有解析。open_deep_research 的清單檔也有重疊的項目：torch 同時有固定版本和不固定版本、python_pptx 和 python-pptx、pdfminer 和 pdfminer.six、PyPDF2 和 pypdf，值得到上游確認。分析資料內部有兩處矛盾：摘要把 examples/structured_output_tool.py 稱為看起來的起點，一條教學陳述卻指向 examples/async_agent/main.py；另外，有一條教學陳述說沒有可用的有界靜態執行路徑，但列出了五筆路徑記錄。摘要的 7,633 條靜態關係邊，和架構陳述的 615 條已解析靜態呼叫關係，在分析資料裡也沒有調和。

專案自己的 metadata 提供了前面引用的描述，並連到一個文件首頁；兩者都是來自平台 API 的作者自述欄位，不是分析器的發現。分析資料裡的 topics 欄位是空的，所以沒有記錄到任何 repository topics。