Your lightweight open-source personal agent.
Python agent-frameworkai-agentai-agentschatbotchatopsdiscord-botllm-agentsllmslocal-llmmcpmodel-context-protocolmulti-agentopenai-compatibleopenclawpersonal-ai-assistantpythonself-hostedtelegram-bot-ai-assistantwebuiworkflow-automation
docs: refresh contributors and preserve historical credits (#5951)
chengyongru66d48fcb7f1e
diff --git a/README.md b/README.mdindex e4ed7f92e..e789b42af 100644--- a/README.md+++ b/README.md@@ -404,10 +404,11 @@ Use nanobot for a real task, report what broke, and then pick a focused improvem<a href="https://github.com/Athemis"><img src="https://avatars.githubusercontent.com/u/552653?v=4&s=48" width="48" height="48" alt="Athemis"></a><a href="https://github.com/axelray-dev"><img src="https://avatars.githubusercontent.com/u/110029405?v=4&s=48" width="48" height="48" alt="axelray-dev"></a><a href="https://github.com/yorkhellen"><img src="https://avatars.githubusercontent.com/u/8706550?v=4&s=48" width="48" height="48" alt="yorkhellen"></a>+<a href="https://github.com/yu-xin-c"><img src="https://avatars.githubusercontent.com/u/175149126?v=4&s=48" width="48" height="48" alt="yu-xin-c"></a><a href="https://github.com/04cb"><img src="https://avatars.githubusercontent.com/u/111667698?v=4&s=48" width="48" height="48" alt="04cb"></a><a href="https://github.com/santhreal"><img src="https://avatars.githubusercontent.com/u/64453045?v=4&s=48" width="48" height="48" alt="santhreal"></a>-<a href="https://github.com/yu-xin-c"><img src="https://avatars.githubusercontent.com/u/175149126?v=4&s=48" width="48" height="48" alt="yu-xin-c"></a><a href="https://github.com/xcosmosbox"><img src="https://avatars.githubusercontent.com/u/56502269?v=4&s=48" width="48" height="48" alt="xcosmosbox"></a>+<a href="https://github.com/KDB-Wind"><img src="https://avatars.githubusercontent.com/u/271925278?v=4&s=48" width="48" height="48" alt="KDB-Wind"></a><a href="https://github.com/kunalk16"><img src="https://avatars.githubusercontent.com/u/5303824?v=4&s=48" width="48" height="48" alt="kunalk16"></a><a href="https://github.com/chaohuang-ai"><img src="https://avatars.githubusercontent.com/u/204865953?v=4&s=48" width="48" height="48" alt="chaohuang-ai"></a><a href="https://github.com/zayfod"><img src="https://avatars.githubusercontent.com/u/1811339?v=4&s=48" width="48" height="48" alt="zayfod"></a>@@ -416,11 +417,10 @@ Use nanobot for a real task, report what broke, and then pick a focused improvem<a href="https://github.com/flobo3"><img src="https://avatars.githubusercontent.com/u/268352850?v=4&s=48" width="48" height="48" alt="flobo3"></a><a href="https://github.com/hamb1y"><img src="https://avatars.githubusercontent.com/u/88080063?v=4&s=48" width="48" height="48" alt="hamb1y"></a><a href="https://github.com/SergioSV96"><img src="https://avatars.githubusercontent.com/u/20419761?v=4&s=48" width="48" height="48" alt="SergioSV96"></a>-<a href="https://github.com/KDB-Wind"><img src="https://avatars.githubusercontent.com/u/271925278?v=4&s=48" width="48" height="48" alt="KDB-Wind"></a><a href="https://github.com/morandot"><img src="https://avatars.githubusercontent.com/u/274257964?v=4&s=48" width="48" height="48" alt="morandot"></a>+<a href="https://github.com/michaelxer"><img src="https://avatars.githubusercontent.com/u/52305679?v=4&s=48" width="48" height="48" alt="michaelxer"></a><a href="https://github.com/coldxiangyu163"><img src="https://avatars.githubusercontent.com/u/134986317?v=4&s=48" width="48" height="48" alt="coldxiangyu163"></a><a href="https://github.com/boogieLing"><img src="https://avatars.githubusercontent.com/u/64551706?v=4&s=48" width="48" height="48" alt="boogieLing"></a>-<a href="https://github.com/michaelxer"><img src="https://avatars.githubusercontent.com/u/52305679?v=4&s=48" width="48" height="48" alt="michaelxer"></a><a href="https://github.com/aiguozhi123456"><img src="https://avatars.githubusercontent.com/u/126325311?v=4&s=48" width="48" height="48" alt="aiguozhi123456"></a><a href="https://github.com/pinhua33"><img src="https://avatars.githubusercontent.com/u/251483507?v=4&s=48" width="48" height="48" alt="pinhua33"></a><a href="https://github.com/pixan-ai"><img src="https://avatars.githubusercontent.com/u/218441143?v=4&s=48" width="48" height="48" alt="pixan-ai"></a>@@ -430,6 +430,7 @@ Use nanobot for a real task, report what broke, and then pick a focused improvem<a href="https://github.com/IlyaGusev"><img src="https://avatars.githubusercontent.com/u/2670295?v=4&s=48" width="48" height="48" alt="IlyaGusev"></a><a href="https://github.com/T3chC0wb0y"><img src="https://avatars.githubusercontent.com/u/68530847?v=4&s=48" width="48" height="48" alt="T3chC0wb0y"></a><a href="https://github.com/VITOHJL"><img src="https://avatars.githubusercontent.com/u/166518988?v=4&s=48" width="48" height="48" alt="VITOHJL"></a>+<a href="https://github.com/KailBug"><img src="https://avatars.githubusercontent.com/u/66873219?v=4&s=48" width="48" height="48" alt="KailBug"></a><a href="https://github.com/macroadster"><img src="https://avatars.githubusercontent.com/u/328366?v=4&s=48" width="48" height="48" alt="macroadster"></a><a href="https://github.com/Hinotoi-agent"><img src="https://avatars.githubusercontent.com/u/275430060?v=4&s=48" width="48" height="48" alt="Hinotoi-agent"></a><a href="https://github.com/kingassune"><img src="https://avatars.githubusercontent.com/u/6126851?v=4&s=48" width="48" height="48" alt="kingassune"></a>@@ -448,20 +449,24 @@ Use nanobot for a real task, report what broke, and then pick a focused improvem<a href="https://github.com/HaisamAbbas"><img src="https://avatars.githubusercontent.com/u/95044189?v=4&s=48" width="48" height="48" alt="HaisamAbbas"></a><a href="https://github.com/anunay999"><img src="https://avatars.githubusercontent.com/u/16853513?v=4&s=48" width="48" height="48" alt="anunay999"></a><a href="https://github.com/flaviovs"><img src="https://avatars.githubusercontent.com/u/1832699?v=4&s=48" width="48" height="48" alt="flaviovs"></a>+<a href="https://github.com/dajiaohuang"><img src="https://avatars.githubusercontent.com/u/108231307?v=4&s=48" width="48" height="48" alt="dajiaohuang"></a><a href="https://github.com/C-Li"><img src="https://avatars.githubusercontent.com/u/20661667?v=4&s=48" width="48" height="48" alt="C-Li"></a><a href="https://github.com/Ho1yShif"><img src="https://avatars.githubusercontent.com/u/75815862?v=4&s=48" width="48" height="48" alt="Ho1yShif"></a><a href="https://github.com/pjhoberman"><img src="https://avatars.githubusercontent.com/u/37924?v=4&s=48" width="48" height="48" alt="pjhoberman"></a><a href="https://github.com/nghiahsgs"><img src="https://avatars.githubusercontent.com/u/24955327?v=4&s=48" width="48" height="48" alt="nghiahsgs"></a><a href="https://github.com/Bahtya"><img src="https://avatars.githubusercontent.com/u/34988899?v=4&s=48" width="48" height="48" alt="Bahtya"></a>+<a href="https://github.com/ZhouJ-sh"><img src="https://avatars.githubusercontent.com/u/9983860?v=4&s=48" width="48" height="48" alt="ZhouJ-sh"></a>+<a href="https://github.com/bingqilinweimaotai"><img src="https://avatars.githubusercontent.com/u/111987281?v=4&s=48" width="48" height="48" alt="bingqilinweimaotai"></a>+<a href="https://github.com/Shizoqua"><img src="https://avatars.githubusercontent.com/u/136805224?v=4&s=48" width="48" height="48" alt="Shizoqua"></a><a href="https://github.com/tangtaizong666"><img src="https://avatars.githubusercontent.com/u/212687958?v=4&s=48" width="48" height="48" alt="tangtaizong666"></a><a href="https://github.com/XJPeng12"><img src="https://avatars.githubusercontent.com/u/50786186?v=4&s=48" width="48" height="48" alt="XJPeng12"></a><a href="https://github.com/yanghan-cyber"><img src="https://avatars.githubusercontent.com/u/188783428?v=4&s=48" width="48" height="48" alt="yanghan-cyber"></a>-<a href="https://github.com/ZhouJ-sh"><img src="https://avatars.githubusercontent.com/u/9983860?v=4&s=48" width="48" height="48" alt="ZhouJ-sh"></a><a href="https://github.com/Yuxin-Lou"><img src="https://avatars.githubusercontent.com/u/117000057?v=4&s=48" width="48" height="48" alt="Yuxin-Lou"></a><a href="https://github.com/LeoFYH"><img src="https://avatars.githubusercontent.com/u/184173704?v=4&s=48" width="48" height="48" alt="LeoFYH"></a><a href="https://github.com/claude"><img src="https://avatars.githubusercontent.com/u/81847?v=4&s=48" width="48" height="48" alt="claude"></a><a href="https://github.com/chris-alexander"><img src="https://avatars.githubusercontent.com/u/2815297?v=4&s=48" width="48" height="48" alt="chris-alexander"></a><a href="https://github.com/benlenarts"><img src="https://avatars.githubusercontent.com/u/131161?v=4&s=48" width="48" height="48" alt="benlenarts"></a>+<a href="https://github.com/wzrayyy"><img src="https://avatars.githubusercontent.com/u/143233939?v=4&s=48" width="48" height="48" alt="wzrayyy"></a><a href="https://github.com/outlook84"><img src="https://avatars.githubusercontent.com/u/96007761?v=4&s=48" width="48" height="48" alt="outlook84"></a><a href="https://github.com/Mrart"><img src="https://avatars.githubusercontent.com/u/5235758?v=4&s=48" width="48" height="48" alt="Mrart"></a><a href="https://github.com/ramonpaolo"><img src="https://avatars.githubusercontent.com/u/53312850?v=4&s=48" width="48" height="48" alt="ramonpaolo"></a>@@ -469,7 +474,6 @@ Use nanobot for a real task, report what broke, and then pick a focused improvem<a href="https://github.com/tangjiabin"><img src="https://avatars.githubusercontent.com/u/21021242?v=4&s=48" width="48" height="48" alt="tangjiabin"></a><a href="https://github.com/yeyitech"><img src="https://avatars.githubusercontent.com/u/231244789?v=4&s=48" width="48" height="48" alt="yeyitech"></a><a href="https://github.com/Flinn-X"><img src="https://avatars.githubusercontent.com/u/54433526?v=4&s=48" width="48" height="48" alt="Flinn-X"></a>-<a href="https://github.com/bingqilinweimaotai"><img src="https://avatars.githubusercontent.com/u/111987281?v=4&s=48" width="48" height="48" alt="bingqilinweimaotai"></a><a href="https://github.com/Qinnnnnn"><img src="https://avatars.githubusercontent.com/u/14584068?v=4&s=48" width="48" height="48" alt="Qinnnnnn"></a><a href="https://github.com/HengWeiBin"><img src="https://avatars.githubusercontent.com/u/45145821?v=4&s=48" width="48" height="48" alt="HengWeiBin"></a><a href="https://github.com/waelantar"><img src="https://avatars.githubusercontent.com/u/70063334?v=4&s=48" width="48" height="48" alt="waelantar"></a>@@ -478,7 +482,6 @@ Use nanobot for a real task, report what broke, and then pick a focused improvem<a href="https://github.com/masterlyj"><img src="https://avatars.githubusercontent.com/u/167326996?v=4&s=48" width="48" height="48" alt="masterlyj"></a><a href="https://github.com/xgzlucario"><img src="https://avatars.githubusercontent.com/u/48748794?v=4&s=48" width="48" height="48" alt="xgzlucario"></a><a href="https://github.com/dzydzydzy7"><img src="https://avatars.githubusercontent.com/u/32220064?v=4&s=48" width="48" height="48" alt="dzydzydzy7"></a>-<a href="https://github.com/dajiaohuang"><img src="https://avatars.githubusercontent.com/u/108231307?v=4&s=48" width="48" height="48" alt="dajiaohuang"></a><a href="https://github.com/concertypin"><img src="https://avatars.githubusercontent.com/u/55056558?v=4&s=48" width="48" height="48" alt="concertypin"></a><a href="https://github.com/WangCheng0116"><img src="https://avatars.githubusercontent.com/u/111694270?v=4&s=48" width="48" height="48" alt="WangCheng0116"></a><a href="https://github.com/yarikoptic"><img src="https://avatars.githubusercontent.com/u/39889?v=4&s=48" width="48" height="48" alt="yarikoptic"></a>@@ -486,6 +489,8 @@ Use nanobot for a real task, report what broke, and then pick a focused improvem<a href="https://github.com/gongpx20069"><img src="https://avatars.githubusercontent.com/u/21985921?v=4&s=48" width="48" height="48" alt="gongpx20069"></a><a href="https://github.com/tobrien"><img src="https://avatars.githubusercontent.com/u/36787?v=4&s=48" width="48" height="48" alt="tobrien"></a><a href="https://github.com/Shiniese"><img src="https://avatars.githubusercontent.com/u/135589327?v=4&s=48" width="48" height="48" alt="Shiniese"></a>+<a href="https://github.com/zpljd258"><img src="https://avatars.githubusercontent.com/u/11162658?v=4&s=48" width="48" height="48" alt="zpljd258"></a>+<a href="https://github.com/FanouZeng-TT"><img src="https://avatars.githubusercontent.com/u/124567600?v=4&s=48" width="48" height="48" alt="FanouZeng-TT"></a><a href="https://github.com/shawnWXN"><img src="https://avatars.githubusercontent.com/u/47786182?v=4&s=48" width="48" height="48" alt="shawnWXN"></a><a href="https://github.com/sbyinin"><img src="https://avatars.githubusercontent.com/u/2064038?v=4&s=48" width="48" height="48" alt="sbyinin"></a><a href="https://github.com/nne998"><img src="https://avatars.githubusercontent.com/u/148901?v=4&s=48" width="48" height="48" alt="nne998"></a>@@ -497,13 +502,11 @@ Use nanobot for a real task, report what broke, and then pick a focused improvem<a href="https://github.com/who96"><img src="https://avatars.githubusercontent.com/u/44131846?v=4&s=48" width="48" height="48" alt="who96"></a><a href="https://github.com/cyzlmh"><img src="https://avatars.githubusercontent.com/u/24603258?v=4&s=48" width="48" height="48" alt="cyzlmh"></a><a href="https://github.com/zhuzhh"><img src="https://avatars.githubusercontent.com/u/41102272?v=4&s=48" width="48" height="48" alt="zhuzhh"></a>-<a href="https://github.com/zpljd258"><img src="https://avatars.githubusercontent.com/u/11162658?v=4&s=48" width="48" height="48" alt="zpljd258"></a><a href="https://github.com/cms19859230182-lang"><img src="https://avatars.githubusercontent.com/u/276597748?v=4&s=48" width="48" height="48" alt="cms19859230182-lang"></a><a href="https://github.com/amplifierplus"><img src="https://avatars.githubusercontent.com/u/160200579?v=4&s=48" width="48" height="48" alt="amplifierplus"></a><a href="https://github.com/LZDQ"><img src="https://avatars.githubusercontent.com/u/45907809?v=4&s=48" width="48" height="48" alt="LZDQ"></a><a href="https://github.com/wb213"><img src="https://avatars.githubusercontent.com/u/488412?v=4&s=48" width="48" height="48" alt="wb213"></a><a href="https://github.com/shaun0927"><img src="https://avatars.githubusercontent.com/u/70629228?v=4&s=48" width="48" height="48" alt="shaun0927"></a>-<a href="https://github.com/wzrayyy"><img src="https://avatars.githubusercontent.com/u/143233939?v=4&s=48" width="48" height="48" alt="wzrayyy"></a><a href="https://github.com/LHMQ878"><img src="https://avatars.githubusercontent.com/u/205284459?v=4&s=48" width="48" height="48" alt="LHMQ878"></a><a href="https://github.com/Michael-lhh"><img src="https://avatars.githubusercontent.com/u/41994684?v=4&s=48" width="48" height="48" alt="Michael-lhh"></a><a href="https://github.com/Mizarka"><img src="https://avatars.githubusercontent.com/u/253529828?v=4&s=48" width="48" height="48" alt="Mizarka"></a>@@ -518,6 +521,9 @@ Use nanobot for a real task, report what broke, and then pick a focused improvem<a href="https://github.com/chtangwin"><img src="https://avatars.githubusercontent.com/u/8316617?v=4&s=48" width="48" height="48" alt="chtangwin"></a><a href="https://github.com/dxtime"><img src="https://avatars.githubusercontent.com/u/8173810?v=4&s=48" width="48" height="48" alt="dxtime"></a><a href="https://github.com/ethanclaw"><img src="https://avatars.githubusercontent.com/u/262543029?v=4&s=48" width="48" height="48" alt="ethanclaw"></a>+<a href="https://github.com/Naster17"><img src="https://avatars.githubusercontent.com/u/62520991?v=4&s=48" width="48" height="48" alt="Naster17"></a>+<a href="https://github.com/L4XB"><img src="https://avatars.githubusercontent.com/u/103962359?v=4&s=48" width="48" height="48" alt="L4XB"></a>+<a href="https://github.com/Oxygen56"><img src="https://avatars.githubusercontent.com/u/100782273?v=4&s=48" width="48" height="48" alt="Oxygen56"></a><a href="https://github.com/WufeiHalf"><img src="https://avatars.githubusercontent.com/u/103879607?v=4&s=48" width="48" height="48" alt="WufeiHalf"></a><a href="https://github.com/stutiredboy"><img src="https://avatars.githubusercontent.com/u/345208?v=4&s=48" width="48" height="48" alt="stutiredboy"></a><a href="https://github.com/stupidloud"><img src="https://avatars.githubusercontent.com/u/56048681?v=4&s=48" width="48" height="48" alt="stupidloud"></a>@@ -546,7 +552,6 @@ Use nanobot for a real task, report what broke, and then pick a focused improvem<a href="https://github.com/honjiaxuan"><img src="https://avatars.githubusercontent.com/u/13818528?v=4&s=48" width="48" height="48" alt="honjiaxuan"></a><a href="https://github.com/DeeJ4yNg"><img src="https://avatars.githubusercontent.com/u/99658722?v=4&s=48" width="48" height="48" alt="DeeJ4yNg"></a><a href="https://github.com/danielphang"><img src="https://avatars.githubusercontent.com/u/1204069?v=4&s=48" width="48" height="48" alt="danielphang"></a>-<a href="https://github.com/yanalialiuk"><img src="https://avatars.githubusercontent.com/u/193742981?v=4&s=48" width="48" height="48" alt="yanalialiuk"></a><a href="https://github.com/zhouzhuojie"><img src="https://avatars.githubusercontent.com/u/658840?v=4&s=48" width="48" height="48" alt="zhouzhuojie"></a><a href="https://github.com/zerone0x"><img src="https://avatars.githubusercontent.com/u/39543393?v=4&s=48" width="48" height="48" alt="zerone0x"></a><a href="https://github.com/yrk111222"><img src="https://avatars.githubusercontent.com/u/185151020?v=4&s=48" width="48" height="48" alt="yrk111222"></a>@@ -554,8 +559,6 @@ Use nanobot for a real task, report what broke, and then pick a focused improvem<a href="https://github.com/suger-m"><img src="https://avatars.githubusercontent.com/u/240725677?v=4&s=48" width="48" height="48" alt="suger-m"></a><a href="https://github.com/mengyhang"><img src="https://avatars.githubusercontent.com/u/148381938?v=4&s=48" width="48" height="48" alt="mengyhang"></a><a href="https://github.com/Liwx1014"><img src="https://avatars.githubusercontent.com/u/186271593?v=4&s=48" width="48" height="48" alt="Liwx1014"></a>-<a href="https://github.com/Shizoqua"><img src="https://avatars.githubusercontent.com/u/136805224?v=4&s=48" width="48" height="48" alt="Shizoqua"></a>-<a href="https://github.com/KailBug"><img src="https://avatars.githubusercontent.com/u/66873219?v=4&s=48" width="48" height="48" alt="KailBug"></a><a href="https://github.com/19emtuck"><img src="https://avatars.githubusercontent.com/u/956861?v=4&s=48" width="48" height="48" alt="19emtuck"></a><a href="https://github.com/tsubasakong"><img src="https://avatars.githubusercontent.com/u/97429702?v=4&s=48" width="48" height="48" alt="tsubasakong"></a><a href="https://github.com/wseng"><img src="https://avatars.githubusercontent.com/u/6572161?v=4&s=48" width="48" height="48" alt="wseng"></a>@@ -588,6 +591,14 @@ Use nanobot for a real task, report what broke, and then pick a focused improvem<a href="https://github.com/pjbakker"><img src="https://avatars.githubusercontent.com/u/1267780?v=4&s=48" width="48" height="48" alt="pjbakker"></a><a href="https://github.com/luojiaaoo"><img src="https://avatars.githubusercontent.com/u/62821977?v=4&s=48" width="48" height="48" alt="luojiaaoo"></a><a href="https://github.com/NearlCrews"><img src="https://avatars.githubusercontent.com/u/23341701?v=4&s=48" width="48" height="48" alt="NearlCrews"></a>+<a href="https://github.com/Krislu1221"><img src="https://avatars.githubusercontent.com/u/258380416?v=4&s=48" width="48" height="48" alt="Krislu1221"></a>+<a href="https://github.com/beemines"><img src="https://avatars.githubusercontent.com/u/182060364?v=4&s=48" width="48" height="48" alt="beemines"></a>+<a href="https://github.com/Wsp030914"><img src="https://avatars.githubusercontent.com/u/134924516?v=4&s=48" width="48" height="48" alt="Wsp030914"></a>+<a href="https://github.com/pengpengyi92"><img src="https://avatars.githubusercontent.com/u/74917296?v=4&s=48" width="48" height="48" alt="pengpengyi92"></a>+<a href="https://github.com/LuckTerence"><img src="https://avatars.githubusercontent.com/u/156219145?v=4&s=48" width="48" height="48" alt="LuckTerence"></a>+<a href="https://github.com/yankeguo"><img src="https://avatars.githubusercontent.com/u/52509957?v=4&s=48" width="48" height="48" alt="yankeguo"></a>+<a href="https://github.com/nolanchic"><img src="https://avatars.githubusercontent.com/u/14110199?v=4&s=48" width="48" height="48" alt="nolanchic"></a>+<a href="https://github.com/yanalialiuk"><img src="https://avatars.githubusercontent.com/u/193742981?v=4&s=48" width="48" height="48" alt="yanalialiuk"></a><a href="https://github.com/yongPhone"><img src="https://avatars.githubusercontent.com/u/29919651?v=4&s=48" width="48" height="48" alt="yongPhone"></a><a href="https://github.com/ZXGERIC"><img src="https://avatars.githubusercontent.com/u/25354180?v=4&s=48" width="48" height="48" alt="ZXGERIC"></a><a href="https://github.com/erikmackinnon"><img src="https://avatars.githubusercontent.com/u/40612473?v=4&s=48" width="48" height="48" alt="erikmackinnon"></a>@@ -695,7 +706,6 @@ Use nanobot for a real task, report what broke, and then pick a focused improvem<a href="https://github.com/kamalakarrao"><img src="https://avatars.githubusercontent.com/u/15045455?v=4&s=48" width="48" height="48" alt="kamalakarrao"></a><a href="https://github.com/KEEPSLAMDUNK"><img src="https://avatars.githubusercontent.com/u/155275575?v=4&s=48" width="48" height="48" alt="KEEPSLAMDUNK"></a><a href="https://github.com/krisLu"><img src="https://avatars.githubusercontent.com/u/92515202?v=4&s=48" width="48" height="48" alt="krisLu"></a>-<a href="https://github.com/Krislu1221"><img src="https://avatars.githubusercontent.com/u/258380416?v=4&s=48" width="48" height="48" alt="Krislu1221"></a><a href="https://github.com/kyya"><img src="https://avatars.githubusercontent.com/u/13448248?v=4&s=48" width="48" height="48" alt="kyya"></a><a href="https://github.com/rreben"><img src="https://avatars.githubusercontent.com/u/4026131?v=4&s=48" width="48" height="48" alt="rreben"></a><a href="https://github.com/ATECHPCS"><img src="https://avatars.githubusercontent.com/u/125108010?v=4&s=48" width="48" height="48" alt="ATECHPCS"></a>@@ -766,6 +776,23 @@ Use nanobot for a real task, report what broke, and then pick a focused improvem<a href="https://github.com/RohitDayanand"><img src="https://avatars.githubusercontent.com/u/66650100?v=4&s=48" width="48" height="48" alt="RohitDayanand"></a><a href="https://github.com/katafractari"><img src="https://avatars.githubusercontent.com/u/1299228?v=4&s=48" width="48" height="48" alt="katafractari"></a><a href="https://github.com/rudy-of-the-corner"><img src="https://avatars.githubusercontent.com/u/188991374?v=4&s=48" width="48" height="48" alt="rudy-of-the-corner"></a>+<a href="https://github.com/fszcd"><img src="https://avatars.githubusercontent.com/u/198843689?v=4&s=48" width="48" height="48" alt="fszcd"></a>+<a href="https://github.com/kkkhoo"><img src="https://avatars.githubusercontent.com/u/128304090?v=4&s=48" width="48" height="48" alt="kkkhoo"></a>+<a href="https://github.com/chrischen-coder"><img src="https://avatars.githubusercontent.com/u/199752684?v=4&s=48" width="48" height="48" alt="chrischen-coder"></a>+<a href="https://github.com/cleverLucky"><img src="https://avatars.githubusercontent.com/u/109461752?v=4&s=48" width="48" height="48" alt="cleverLucky"></a>+<a href="https://github.com/n1uz1"><img src="https://avatars.githubusercontent.com/u/149388665?v=4&s=48" width="48" height="48" alt="n1uz1"></a>+<a href="https://github.com/shakewingo"><img src="https://avatars.githubusercontent.com/u/42901821?v=4&s=48" width="48" height="48" alt="shakewingo"></a>+<a href="https://github.com/Kuang-xianxin"><img src="https://avatars.githubusercontent.com/u/243476082?v=4&s=48" width="48" height="48" alt="Kuang-xianxin"></a>+<a href="https://github.com/0717lee"><img src="https://avatars.githubusercontent.com/u/185926419?v=4&s=48" width="48" height="48" alt="0717lee"></a>+<a href="https://github.com/loseintwilight"><img src="https://avatars.githubusercontent.com/u/247379972?v=4&s=48" width="48" height="48" alt="loseintwilight"></a>+<a href="https://github.com/AlfredChaos"><img src="https://avatars.githubusercontent.com/u/48818977?v=4&s=48" width="48" height="48" alt="AlfredChaos"></a>+<a href="https://github.com/BenWituka"><img src="https://avatars.githubusercontent.com/u/325817656?v=4&s=48" width="48" height="48" alt="BenWituka"></a>+<a href="https://github.com/gary23w"><img src="https://avatars.githubusercontent.com/u/61893883?v=4&s=48" width="48" height="48" alt="gary23w"></a>+<a href="https://github.com/tilladam"><img src="https://avatars.githubusercontent.com/u/555247?v=4&s=48" width="48" height="48" alt="tilladam"></a>+<a href="https://github.com/DannyYTL"><img src="https://avatars.githubusercontent.com/u/125264206?v=4&s=48" width="48" height="48" alt="DannyYTL"></a>+<a href="https://github.com/yaoruiquan"><img src="https://avatars.githubusercontent.com/u/179358755?v=4&s=48" width="48" height="48" alt="yaoruiquan"></a>+<a href="https://github.com/GUTYL"><img src="https://avatars.githubusercontent.com/u/35319275?v=4&s=48" width="48" height="48" alt="GUTYL"></a>+<a href="https://github.com/ZedingZhang"><img src="https://avatars.githubusercontent.com/u/50742926?v=4&s=48" width="48" height="48" alt="ZedingZhang"></a></p><!-- contributors:end -->diff --git a/scripts/update_readme_contributors.py b/scripts/update_readme_contributors.pyindex 734b3f3d6..a6488abdf 100644--- a/scripts/update_readme_contributors.py+++ b/scripts/update_readme_contributors.py@@ -6,8 +6,10 @@ from __future__ import annotationsimport argparseimport jsonimport os+import refrom pathlib import Path-from typing import TypedDict, cast+from typing import NotRequired, TypedDict, cast+from urllib.parse import urlencodefrom urllib.request import Request, urlopenREPOSITORY = "HKUDS/nanobot"@@ -23,9 +25,23 @@ class Contributor(TypedDict):type: strhtml_url: stravatar_url: str+ contributions: int+ email: NotRequired[str]-def fetch_contributors() -> list[Contributor]:+class CommitAuthor(TypedDict):+ email: str+++class CommitData(TypedDict):+ author: CommitAuthor+++class Commit(TypedDict):+ commit: CommitData+++def fetch_pages(endpoint: str, **params: str) -> list[object]:headers = {"Accept": "application/vnd.github+json","User-Agent": "nanobot-readme",@@ -34,28 +50,61 @@ def fetch_contributors() -> list[Contributor]:if token := os.environ.get("GITHUB_TOKEN"):headers["Authorization"] = f"Bearer {token}"- contributors: list[Contributor] = []+ entries: list[object] = []page = 1while True:- url = f"https://api.github.com/repos/{REPOSITORY}/contributors?per_page={PER_PAGE}&page={page}"+ query = urlencode({**params, "per_page": PER_PAGE, "page": page})+ url = f"https://api.github.com/repos/{REPOSITORY}/{endpoint}?{query}"with urlopen(Request(url, headers=headers), timeout=30) as response: # noqa: S310- batch = cast(list[Contributor], json.load(response))- contributors.extend(batch)+ batch = json.load(response)+ if not isinstance(batch, list):+ raise ValueError("Expected a GitHub API list response")+ entries.extend(batch)if len(batch) < PER_PAGE:breakpage += 1- return [- contributor- for contributor in contributors- if contributor.get("login")- and contributor.get("type") != "Bot"- and not contributor["login"].lower().endswith("[bot]")- and contributor["login"].lower() not in MAINTAINERS- ]+ return entries+++def fetch_contributors(previous_wall: str = "") -> list[Contributor]:+ # Shapes follow the GitHub contributors and commits REST response schemas.+ entries = cast(list[Contributor], fetch_pages("contributors", anon="1"))+ contributors = {+ c["login"].lower(): c for c in entries+ if c.get("login") and c.get("type") != "Bot"+ and not c["login"].lower().endswith("[bot]")+ and c["login"].lower() not in MAINTAINERS+ }+ anonymous = {c["email"].lower(): c["contributions"] for c in entries+ if c.get("type") == "Anonymous" and c.get("email")}+ # The endpoint only links the first 500 author emails to accounts. Recover+ # counts for existing credits from anonymous entries using attributed commits.+ # https://docs.github.com/en/rest/repos/repos#list-repository-contributors+ pattern = r'<a href="([^"]+)"><img src="([^"]+)" [^\n]+alt="([^"]+)"></a>'+ for html_url, avatar_url, login in re.findall(pattern, previous_wall):+ key = login.lower()+ if key in contributors or key in MAINTAINERS or key.endswith("[bot]"):+ continue+ commits = cast(list[Commit], fetch_pages("commits", author=login))+ emails = {c["commit"]["author"]["email"].lower() for c in commits}+ count = sum(anonymous[email] for email in emails if email in anonymous)+ if not count:+ raise SystemExit(f"Cannot resolve contribution count for {login}; README unchanged")+ contributors[key] = Contributor(+ login=login, type="User", html_url=html_url,+ avatar_url=avatar_url.removesuffix("&s=48"), contributions=count,+ )+ return list(contributors.values())-def render_wall(contributors: list[Contributor]) -> str:+def render_wall(contributors: list[Contributor], previous_wall: str = "") -> str:+ previous_order = {+ login.lower(): i for i, login in enumerate(re.findall(r'alt="([^"]+)"', previous_wall))+ }+ contributors = sorted(contributors, key=lambda c: (+ -c["contributions"], previous_order.get(c["login"].lower(), len(previous_order)),+ ))avatars = [(f'<a href="{contributor["html_url"]}">'@@ -69,18 +118,18 @@ def render_wall(contributors: list[Contributor]) -> str:def update_readme(*, check: bool) -> bool:- current = README.read_text()+ current = README.read_text(encoding="utf-8")before, separator, tail = current.partition(START)if not separator or END not in tail:raise SystemExit("README contributor markers are missing")- _, _, after = tail.partition(END)- updated = f"{before}{render_wall(fetch_contributors())}{after}"+ previous_wall, _, after = tail.partition(END)+ updated = f"{before}{render_wall(fetch_contributors(previous_wall), previous_wall)}{after}"if updated == current:return Falseif check:raise SystemExit("README contributor wall is out of date")- README.write_text(updated)+ README.write_text(updated, encoding="utf-8")return True