From 990297b46323b9ea605b2c61e58c5fb567ad3947 Mon Sep 17 00:00:00 2001 From: Denis Mozhayskiy Date: Wed, 12 Apr 2023 02:18:07 +0300 Subject: [PATCH 01/78] Easy run bat files with requirements check --- run.bat | 8 ++++++++ run_continious.bat | 3 +++ scripts/check_requirements.py | 27 +++++++++++++++++++++++++++ 3 files changed, 38 insertions(+) create mode 100644 run.bat create mode 100644 run_continious.bat create mode 100644 scripts/check_requirements.py diff --git a/run.bat b/run.bat new file mode 100644 index 00000000..081af67c --- /dev/null +++ b/run.bat @@ -0,0 +1,8 @@ +@echo off +python scripts/check_requirements.py requirements.txt +if errorlevel 1 ( + echo Installing missing packages... + pip install -r requirements.txt +) +python scripts/main.py %1 +pause diff --git a/run_continious.bat b/run_continious.bat new file mode 100644 index 00000000..812aa01c --- /dev/null +++ b/run_continious.bat @@ -0,0 +1,3 @@ +@echo off +set argument=--continuous +call run.bat %argument% diff --git a/scripts/check_requirements.py b/scripts/check_requirements.py new file mode 100644 index 00000000..a74ba367 --- /dev/null +++ b/scripts/check_requirements.py @@ -0,0 +1,27 @@ +import pkg_resources +import sys + +def main(): + requirements_file = sys.argv[1] + with open(requirements_file, 'r') as f: + required_packages = [line.strip().split('#')[0].strip() for line in f.readlines()] + + installed_packages = [package.key for package in pkg_resources.working_set] + + missing_packages = [] + for package in required_packages: + if not package: # Skip empty lines + continue + package_name = package.strip().split('==')[0] + if package_name.lower() not in installed_packages: + missing_packages.append(package_name) + + if missing_packages: + print('Missing packages:') + print(', '.join(missing_packages)) + sys.exit(1) + else: + print('All packages are installed.') + +if __name__ == '__main__': + main() From 02f23db210b5fb4a4cf93eb26d1e0556f4685315 Mon Sep 17 00:00:00 2001 From: Juro Oravec Date: Fri, 14 Apr 2023 13:00:55 +0200 Subject: [PATCH 02/78] docs: Explain OpenAI billing for API key --- README.md | 13 ++++++++++++- .../openai-api-key-billing-paid-account.png | Bin 0 -> 316093 bytes 2 files changed, 12 insertions(+), 1 deletion(-) create mode 100644 docs/imgs/openai-api-key-billing-paid-account.png diff --git a/README.md b/README.md index 0f2ffc75..40e75487 100644 --- a/README.md +++ b/README.md @@ -105,7 +105,7 @@ pip install -r requirements.txt ``` 5. Rename `.env.template` to `.env` and fill in your `OPENAI_API_KEY`. If you plan to use Speech Mode, fill in your `ELEVEN_LABS_API_KEY` as well. - - Obtain your OpenAI API key from: https://platform.openai.com/account/api-keys. + - See [OpenAI API Keys Configuration](#openai-api-keys-configuration) to obtain your OpenAI API key. - Obtain your ElevenLabs API key from: https://elevenlabs.io. You can view your xi-api-key using the "Profile" tab on the website. - If you want to use GPT on an Azure instance, set `USE_AZURE` to `True` and then: - Rename `azure.yaml.template` to `azure.yaml` and provide the relevant `azure_api_base`, `azure_api_version` and all of the deployment ids for the relevant models in the `azure_model_map` section: @@ -145,6 +145,17 @@ Use this to use TTS for Auto-GPT python scripts/main.py --speak ``` +## OpenAI API Keys Configuration + +Obtain your OpenAI API key from: https://platform.openai.com/account/api-keys. + +To use OpenAI API key for Auto-GPT, you NEED to have billing set up (AKA paid account). + +You can set up paid account at https://platform.openai.com/account/billing/overview. + +![For OpenAI API key to work, set up paid account at OpenAI API > Billing](./docs/imgs/openai-api-key-billing-paid-account.png) + + ## ๐Ÿ” Google API Keys Configuration This section is optional, use the official google api if you are having issues with error 429 when running a google search. diff --git a/docs/imgs/openai-api-key-billing-paid-account.png b/docs/imgs/openai-api-key-billing-paid-account.png new file mode 100644 index 0000000000000000000000000000000000000000..8948505a06313004302fe525d3629ffa9b857bdf GIT binary patch literal 316093 zcmb5V1zc3$wm43R2ui1*fJ%1>(jXz-ozgjU$AEw$qJT8gA>CaAA|)UlLl0d83_ZZW z%x}E+zW46ue&7Gz_doMF=j_>gueI0SXPve7iW9A={)Pab1|I_hgFs19P8$Q`!F>!2 z9N?cT227y}eZwzzl$F&~l9gr9^mMaxbg{+2P>fDa#nnulrwoIkP!28eMO*upTR7N3GWPU*W26AcZ`jJ=_E}u{!Sz{ zmCf$`hx^#NMF)_ryQdgm7EMw%T9J1s6gzvc3^Nf1EBV$vAT!U?EwYl%)o3Oo3euCCMvdiyrdE%<=Gi=7(7b+J$Ur|;M zi<*J@ZVOvF<*m`|mBQTP^(|6MZBNRG_no|$5iiz_My%%M=jO3_k>)JbJtjB3Vv)NB z#UW5djFy=G{(j@)5SbjzS9!P?N9%+h8_anb)nC}B@5A$WSt&n7B`}aM zzW2=Y(InA*lq`drOS4P0OYTkAhUFsz&og%*4#W=mK$7-o>MdZ7y6HnY??b}y7pw2x zNjvV1zB^k}b7wQfr2jy>c6R)-1vjOeXN}|@1O9`j6SABn%s&-g$G>7E`N~ip|GMyA zsr3F=%0lec_rKzwZIa!O%Cn-TR{2cJj6oK?W|{I<-%`kGh<7GUK~-#1mm zpHrBUZ?iq1I3-u6h-Ej`-_^U4(`U*^oZrN;VGAH@{S+J!+B-h}ekf?o!vm4;PwC3BTm%F!h@g}vIwg-Hdv`QD~`A134ZwdM`eD}U>m ze>bfPR=%z}{fMvEr_UtEWM*5STscIMyi?|{XRT+U*Xh)`FEjJ7EJQcbN!nH?VA^L| zb~BDPW+;;g^Rp)9nVM3ts*q3l@!@An2`&(ZMCl49NFAgVLUyNk*LXv46GxzUUo}E5 z;_yD;e$R)t4_=SF2%wMXsY$-1DGVxzeG&aENu5FchPGPRl^^Ju@A{K(kgrrAz($$x zLeR|0*fMbOk$u0Q%F9J-->D};eu5f8Ji=X;m?p1`9&lY6dXM}Z^-O2_rpE`ZVwz8| zO$Qj+&pXRE<2M;Q&)8fHEsTqf2A2CoT?o^@$q>wt6(R!Y0k8q!g{HaAT7l+``Q*jr zrs6roe07ssQ|RH_H3s)NsQcL0{Z|7XAnS|`0~ULhXdTd0Zhf9t$C>L+yDE)9QtQ`% zc^v5aVco*_nXSa~MCTMJAGm9Yb6I=YX*qjLD4i=U#KAYGy;BT)7uNneVvPh=3z6L} z-5I>7I1b*oUG0OHozuKcuhlk;GOF$XbTF;3fTU{7<~inff{E!vb6)4DTj)U)A^Z>) z;0;g-=mYFQ#v(ax$8g?ahhsI}U)pl;^3S9hb#(7v0FqZyeti$+2F)dbaqQF6vt(H{P8OovZn7$7#UWPnRCg9?_qrYcV~}J&-s4 zZ(L&isU2z9zPQ9_e=;W4BfEIEz|!{0n9}-bJ^!|Ggl-I?SG!jWS3FC^t~h>-?-FaoEYk+I4>v)Z zK_|^;xHw1QR^8J1K~^5?XN>SdfKtR@_8`-s?CYi))hkgZ23w1vsOk9Wvgz7}-G&d| zuLFZ`*uIvr>P=_oCDw8lsJJ}iCLT^{;hwLxF(hRy{T<0qWhZ1mG2Xq~Hm!RT(IC9| zqFo%ZF1gd56UccA4H51%0Jz|O276}`)+5ewFPF^O0E#C zXan`P78U82`+7Y!WvQeU?^rz^c_I1c8GQwyYw6P8&h)h#X#4O_EeGSwe=$Q zZ$_iX2(mOpA>gK#!?pKm51SWv8vV>4wfSEsK)yeGS`k~Hy3EsT?g8@LXFqeAdRgrJ z1^l!+=XT_zIWbE;>x*!vn;^uyb$;??J5;sV9)4{i+04DXz0^4?&|C~v-^>c~qgqN{ z-hc!Fr4Er$+<77e`fZ7ylI+11w=J8|vx%P|BS5!!kwJC%&AE9f4f5QQz8bbgpB@^# zHx{Z8pwFKxrg^q>6adYItd3BfS)6x~cRhK^ex!d$^x5$!~t1vOHOKU$j)>Ic6P_G3skyRyOMw}5euhWyNd<2=e2x% z20yc?afo%-dgU-ybTOr)al!)0vgo%pMyJTI)PUHk#8(>PB3>FF$uKTT9@EFn?O?q6 zROUhVjdtebE9=jPKQ1plv%ZC}Y@d5{=UH$fLi+cRP45F%>G?%^Lcwq;F6yy;45T9p z$4(2E^+_aqG2I%jxImIz`-QNz($ua(LW4K8VsDjl`$}sF=_w1tc}U~ zk3Lu!7*UQG_x{nx7=8b9#G_9%^gr&{2_G%%XJjtcfAxNFKNtJI$~ZuD8-|RI ztdbJ?u4Cd{>-2dRg5cd~F7Xh~3mJI#?7gsM)e~IUR>miCR|EcDA&hWP`-p&%w4b?Om zWZgV%8HBibxp|*U;xjNXh+i#f|3N0I>F96k zVkqYbKrc0#G)aEmmxAJd8|N=g|3m5DLG`?BJ!RbhXh?6#|9M#d0RHF3e+B&8m`49I zCZ8a$&_9p)Pfh;>`ezcN+O}S9Eu9( zuMmd+E5tw7{wsurrz3hHEdP)u$@h;D{<-cS{l$6yJp6xRhQD*#-)hmUCW$Z3^WSVM ziGSwo{~QBD8be7=M%N$nU>P?|cV-@SVxPLw{x;8m;@&|x4#hz~orxS~ZLZtrml6Sq zw-9obvRZ=!v+h{4ZhS*blKAJWAD@GIP`9I=M=M!b^ULX3m1h!zul!u4a)RuA({@C5 zHV+%&xs?hs7?}5nrT@d_oiSUy1&6cz_y5@Q53(N*F_*CaBTh7;X)8=pY^RgH?@s@h-e_Va{sWzVBkunnvC?J_h^2Gw9=I&E zObE3O^p9k?3~!G#1)NbXw&}%HzAV7XWcs%YB(09OxwU0vZr(Xln&@`zvu_9z^{I3P z1?rDUuqJazTS;#PdI{c}BsFXXf+{V#MulAGq_L!pJu5!{+qKl3!E#z{^MTqe*4fsl zJ7cs17xCCEbItE=W^-j^o#%38^m6RfpXBt0Ww!j*tz*V>nXl`ctuk|lE?LJwNy5Va zE%q>J0IBBBANRr1`f)Q=Z{B_QLSys-{%dTkT5YC6-{%=$uCW=RI&&({IcAI92o2mY zYxvRh(|^l?3{m%{HT6&UBxr3Y#g{r|>S& zUjN1^_wRW**B75v^l3wY+^-~w`X?nye7~0fTb3`%0t7){}u_xy9MqV*F)pQ z4#&io&a+GV)1^9#l2UH(0n$9rMX7)#f_Ou!!U+f#bPnnQ2$B0eST z1Ce28@O!{~8`J+`KBg3!E^2&2eG9DVc=6Qn>9i)#;=leFO6F$!Vf#|+KS__=1FTQA zY_kf3s$sohznA9l-!G}Lu;h%fFV?Nbh$ zt{3dH0rL%mr^3}uqFxsDGd#=A&O+b8DgjMnWv6{2&#`7q-$G|An*wLboPa5rbpPR@ z*^=!}mlo`4>B-j$_pO%I2}&H>l!vZfr$8E##R!;iHq!wp+dK zrHs?WPi#V{!f-nXUsF9ygW%T~&`R1ID1#MwSzX{_-nBFf^E6%1tG<-Q`~27|FUx-t zPssN`Lg?}+XtE0J4|=Bun19$hU%XG_xLbi3peS*_B&}k2r_KneYj=f(q8@yj=g=6jKa+MS`^Si2nd{Mcn_)5 zlYQLMjorlh_=iM$-aVI?hbvH#m_8WfP+NkuBr&q1L$t~AqOBoL^QE$_xEhXcGI=h4 z@RgD6QrTr?Q6WY$9k+Dnz!A2y1y1u!NhoUhpsmZo8NMtv+i&Wfx96jXKhFMbR-9`} z)L6JvoUkBhr=};W&t7lv+*r6Dk4gBRaif!wZK%JeY|ACM&T*=!X_#9KjQpf6dyicy z7qHl5B&Ch!oeI}wQ6mVCScN$jg$GQxn#NP;FAS_n_s(BC>{7u0_${r-`oZZzT|c1w zerH~9aZkrkaMh5ZskylfskHy)#i*yYbhqR~`7TmQgS(LB zx3t|(d-L|xMracE0nN1VUBPOKi7N;Htf3Nu$8lbXCClNd*=2Je zb{h(b>#{cqo0M!GT3W5?`CybI3A%d*YlFI))LPlv(se4(l{W+xE9iepRQOkQ@vZ`& zkr^j4i$g@3$smxBTFBd>q>VtryF@MR*z>%tj)gqNc|DM!`cwWaLQ4Y^N9~&9R&d%m z4B6%5d;=oY9qtY5{c#k-qgq4j+EV-TSveGw{J6xRI@@P|X)wnMpiJnn&=7sM78iOf zf!TZKGa_}f`y%6IP!k*9YxzMEi8jAx83a*X_hOsrfCchXX z3yhX(W^T_+1dW)!d!=&w{*b}V$ky8)$#QnyE^ zBgrN$rqyh7hk!SyS^$|A?0qtKms;zk44C-i$u*lebQeH6O`saezX-)?{XgtXQ@GpA zl8p1P^R(;fma^xMAMda$)iQ)8Y+Vo`^5e06=24L5#7WY4DO5*$ zZym|~p5M*fa#iy8@Oc38_Ijddf6#U!zq$aNu3iEUpD72o{NCsXQq`NSTlsJ++dSC0 zS@xT0w~yH0G$etm`;^h|{8eYBKlI+8p12QiZYYxrEAIc&9J4$QW+xKAia&(4&4NAq z%8P(k9?3X^0@arD%}>Nj+^OHyBya2KS%rCMmn#oQc#)PFv-TdWxu!!v$OKlPy5;N`72nj z(|06ISZ&ElN`i`A-q>^f#XKq*#iG$aJsY!M@PlyqL}L)O(_x8HiYzZK!?bPyGG|nr zC7`YW@^eDoA7C>)Qg#}k*Xj?Nfbz1gqrNzVg>&a)1Gx5un;@p|q1gw>yovhvQeWtg| zH;qESFPPnPX{}bXTm2M<(-bw{#-V2;bahbgI3Y;(AnDC&vVnzw1S``+;$zPFVrH&o z$Kt1Vdu8_Ts=K&XbTk9@>#X|lQ}b>u1AMhyOqjwQ{fob8w)yd>wxvmk1u0Rz%sbkW z82HrUHx#7q@>g}N$5Vse#kb#lb5;>2xp<AYh@LqEsJ%jn5%-Z)kiV`Y0lnsIHdg+ZCbiv_QdcER(MGkSp5ij) zVs5kBJSk+2zqA|(mz9s9LT7$wuFc1}+@dSH(yV9!-d9rX@3Yr|Ly*bvC8Innu2Lq1zJiq1*Eezd`FB>QS+6LYLmIq_MVqVs+q5cwduqwm zr!=B1mI3?bCa0N&(Dd8=@@nM{KT>%47{2X*kmKZZ=bf+8&{%fw;ZNr;V|vG})8nCZ zLk)#zsg0e-`@?QZ(3cLHkPy4+6J~tR0TpT@z(zko5ws-#Ld<9X;OKg!^Zjj^Uio^4 z+!O(=&^i25l_Tqd1+_B6yw8ltu#)Y3ovmek(%61*?geJ{8r?N6fkZd)~had zxLJ2%u$XEw`V!=K(OOAr!PA+;TY1sYseDVvwHHF#G~*@e^D)POJ<(l~2^9B`K&TDA zS9G<<`{ggYTMCA8^y`j7s0V`|QU-4UV+_f1DAbDEfen@f->Ah~a&c|%vPo&SDOb}JQ?7xX*D%P3FZ<$ZVJ42$Lci+-hb+PHaRLRWohb6Um zGVv_6wC;yis8RA7A!Sc;eQYO#kC9@M{)Ma8d9qRS7hu%l{X+w9PMSLgNyo`W-%F7f z0yOq!-RT)_ZQX?8#~7g%{&z`Sm%r=B=D(+!)8zo%Gy;cN?)Tc8-_)z95+xg$2h1pB z1!YS}AeCa8^=J9NJgh#{JGTza$wJ&X-o2@`bZft`gD$uG3G%42viia2f)2()kkYlNhB(qN>6}DpT(YY3#<=}rcJXJ0)mW<8jX?Wq_}Qlr z%n2XO{C*{t9OHwSjiYv=h5@>eIhgZl5}R+G2}|PXRF1jJPL5ypOV=gVh1=$?>&C9m z`p&DLqp!{?3I{oijoxuAtH^$MvWcBJLAVq-dItbw5B~aEP>^dMeEo1t%6ieQ3zRd{ zK2{}kR60;;P#xYIUX$G)j~X_e5Br+z>6 zom*i^U?h~!_tN8^p3;!gu`)1LwwoUdVP@w|H|)ILriCMcE7RXZYM*%ho|yfvA_G35 zNm-8~&$-yi3C*rfZ4+$YN--%|-US7n4zgT>r;0WF@OY;Vb_?RzeM9uC&8;{3zi>=` z=?q8gWQ*}H7^G241nQ=FFNy=AWpR3?R8;o&&B5nk*q3k!ZBhv-&&`{;s}l_t5X+dD zTSHgzMQiZJ7vTZnVgH-WM2+)7=7nxG;bm<`JXu&k7Gx-y;}D6UZ_rT}na2ff;Oa=5 zp$9KgiyPzSuXN6{Oh|Ge<7q=NtNPEQNjbcHS~c?s;-wudp~k^W-=vZ3{q+b`B$r&@ z%;d9AA0iAf^+z$%p(4p*o1gkEb&mm0`taoUIbPf?FW9DL#efF9E6U9b1;`O#g_a(Fe}4X*FpV|;UG8GXVMpn`nm%fK<|nf zFPZunZuQRCrgDSoDhb5zsm?y%bzlP#lXeMHCn*={@Y$F|mLQ27bWfD^t;9*C@WHQw z*h`t?8c^W72TWtit@J&g@W!Yt1eulXlnghk-Ci}V7|@5Dd#tlx?!F+pHmCf=NL%&yca?XUk>uq#>NRBkhmx`^E&jo+(999YC{}81giO8f5!v1B-&I? z#oQMUW#zYtF|LfG_VBHZjCW@Ml;3-Vb2#vYmfnskK=N|VI(Upu-p(~BZ!8XZhiJd| z@#(?D8+s1P&-zeT955Lfenaa@vFK5{eYWM86e^rPhVz7ae@o`wsIEMSJ~Lo@&$k%y zM$T&8;MOa*Ax_}1>q_)JJahD{mrO&^IF4D32Jyp2{F(uHpu1y!>u-m4r+(4T5!e}a z5cOEU+KA&wNq#!3<$Ozzy0U49uONCV@PXXk%09WGKKl!3ONSC?djrZgC?gTSYp$E1 zY^7DrRC?fpdg?Pxa=BNWBcH+KHS<$F3%`@fNz`ako*Div!6%72KS&yNrK5p8Xna*3 zs~oST_4>DJ>LUssLT(gdU$JnA=~#95QJFbNq561KTm+MnBWzp9?p%>C;EKhn{(D;v zK586%(%*H8V<&FoO*MH7c99pfhdOM);xE4O+j7Z$+mi&lQGt87l6MDYpXY~phE@C|tF zK-OC>Q)!kYv|=Q(*cGNl66u@grF>F1W@(d0`nx>6+8*@b^>}4d__GVvVIN0FC<;Yymdsf+pfz zHUf56Ol5eMammbxC_QNewy|zz>oKO)n9WpsKx2#SbqjBA7zo)hqIVZ^MYl%Yh5PtN9nV zZG*`Ao$R0+{ShL`^O}(L@SHjW1~vK0SXu2btk5{|n-Zu~XlbYvo#%19!&96fSjz@C zN)(xMl{$2NwlhF=9r+xGQg509$&wSi{(&bA*1mYOS7p%!47s~7kZ!A2DN%WpM&~{L zPD?xN5hbVLD)to)-cyiSjTdegh%|n>Jj@stl^?X-Fs1$_d=EdD9a~?PnDyCfm>Ou{ z{MxIK*4(m_R$r#FN_KArl<~Bq68Wt-o6K(H+gAG=Y_>83Wva{nb-y_G%n-b&xO*gZ z@WNy)ZwEK4o!^gwSl<}{3Vl5pv40#!J1QrS_atwtZW}7D*B=+!AJR|7ILL(P(0;2g zKYQ~?RiE5uHt;=o<6)O^wYkKd6z^s!L+w#59+|mvQ;c#BRUlOJc}n{_4O zP~uloN51FkJKUQUmUXb^FnYH>@b%>8f_4d#nl33_C3?9#(c=xfIBa(=_1RwmIX9?V zVYG_F7to5C=0d1`(KRITGCL1$tVlT##A*Hpr@sfncJVqtD0sF)L~>plEVvY;Jl+cH zMCc%8TeE1jU)%P5NQFu^w3|t{?R2Va1K=Ayt}!GvHN~zCO9R! z3ybbd-G$lWrfw!0COshLky!T2>%CVs&hc?}%8v;DFD^3O%rF|I_ooRD12xi(UwPL9 zg;n($R3-2u>kvOMCFyd(3-(ReYiqBzLS_TFe7Y=>k{;zjgj2ZhM(LHiLi$6!CK|Br z*5DpY`X$fg$~*_M{N{V36ScWU{eiXv+qcpCer#|t+loVry&ag)d>QY06Qm*ON&F7Y zwCi$Rh}Q&e?mVZG7ptOR`N>~IEb9&_op3_)3f&Ci6z_6o`F#2bAk4(@OiM&$MK+=au$F5!>O$9v-Dcz`G6$CIvI8|t(YH>QvU3xS#P9|Xcno7J`r z+Aiy8Tc8n}Q2dpr=D1c0eW+j`uCKTFm()VnZrKT>9(nE!EYwYKc`R?2Zi@H5hU7_F zPU8TbJocF-NHv?{Bj{+Myg-cwbl2o;Bq<&k0tq3yLY$zff`eNE&bH;TO7Y9~?}&$Z zLa&_@Em-Sx3@%XDaH%^^A81w8&m8~t!5ZbS_Bb6;PsFD~luY+`pekFc!k=ZRzsU+n z-5$RXTkB0MIHU_Y@W{y|9+kC7NMyQC4zQJESuiJiR#Oyoi+258Zq!9lP;y=k`Bhgx zQ_yY5@wW;KM`ACho@<)BgXVkN1yJa1eF*=%{mOiX$|KAW$`V#S*=jv#wR_5(=Cy+4V?sjng=mN?rmcE<}gX$Ox!%&$yh4yBPK? zgTJzu`R)4Gy#tCN<7f%_U3G0DJUdGc<}#(s;3g?pw@?F@Ca$UpcLzZoZM{?Iwh>6d z2R{KbIN=B7VvSQhDyu1e!2w@m!_>cw4Xk3{>^1po z1MR*OUT6$=J}JcD8lT&;;9-A71&YOWJ8x@9IJ~j*bSrrXCr;DzwGwAz$V62(uWUy| z1#)>c-m2=2ilKh8vN2S=7zUdMNpv&-Ll6p6-(GFcZQS00D}$<^D`8qPH6l$xfsLW_ zRc10_ESwx;^=+v{T&+QuFBIi}GWH)x z#QN#sP4r&6XhkY7^=plI*3P&|SW`5M1LI;8){j3BqYaKzchskAKEXMb=6Vw4&5&o{~MF#rqO*YOs z1)`$5sFaT$;z{=DtEOqKi1tS5X^s)({o)E{j)X^SzrQD2S!_=FbEhN0oAs|z*IKN7 zq}1YfwTy#1=FCH{hlmVOpEBsl>cVqS7JE(TLMaZxho6DA0s7%GR_O4onHJigT|5*! zvX^Ee!UaYaJ z2Q1|F+g7Dwz;&#Oxd{#@WsT?QV;!tRMe`f)s)LXbLCC4El}imlzHw4*dl35BA*83S zv-2X_Svjv8&zpP3>O9B;{WNc?QF+bLrrXcQU)l3n*@Mbo@cq^F)FHK8pY6*VLB`AFyK$Oj`ZLCKAK1sw-{C&VEw+;9dNaK6 z&0{o^Ck9ac*vkq;!OD1YI5ewDJyvy!djZ3?wwO& z>r$7W0?Rw7v6jK$?BG5$deH3P+Z~Qzrn4W2 zt|#)})j8sMJvSeS`Tru;Nd+lmXb!iJPgYGoP4aqQW%kg7<-=@asqb~?!%5WUZ-Lu& zA;71mjz^0nJ|0FY;=4&s8RJ$G9sv(tF^}>b`ZPf^_CO@C1=Ak!OwXY~B@GE6{Xs3_ zNC~V&F*h^hVGVZFs6A{%<=k$niv9Gv2Gu)uc;Mu13~)7RiP-m=(1jj%Z#KXw$ABR_ z%W!R1sf(VUVQP2fOhi7Pvti{qqG;K?kn?0<9^)8!L)?vom4QU>B>u}MUo!bf@UF=?s41}ozE*0 z&W%FF{2(E3CvCqy)@W0F^uvC`JcF+w7a^AA23rADDDtr1;Rk6c-Ew|n$$X#ZpP={r zl|#DmCC5B-ZG~woyN7-)IFUueR~G0EKf924j!Y-{K%!YUxzu|036SBWfKI75CqD;C z!YiXf6W`0zxLu6f*Tq_`EbLzaj&ts`9qsPkW#fDOzq*&AIp&NnKX ztQn)+AT6<0ciha$PUYc{W-~>I`r%CPk^{yi+ygR~Sq+}MpK7=Y^z_og6;_qTlj?MJ zmmr_^L&Tvv)Ak((w+)o6!qgc*lh7w%3%ZsmS25yV4cV*xTx#(K!A75RuXy**Nx(1>` z_AxSIg+uy3@7A2Gx(L?aS4GaO=MuTKW(PB61< zhB=(fJGMM-v)Q31NiDf`gN?e}d&B8iH~59`-v$}Mb1E;^l~}#Df3r22T%+|m-s6k= z`J2xuaF&%-G!@0&#SKepx2CvG^4=;hnqyAHQ|A^YeqyD_nl6Id?e3e)Xr>pl8yCHG zD$C~^^X|MMH8qoz6*!3r-A+2rf(UHxP-!TBLi8qbuXnpwCVmN01IrCcp`$%#)+3Fs z%R`+gV7i9O1CUV38zPByrj7x@YR;T7W1c1GH}z)LJh^Djz))Ybj9f64V2>Q@@NTah zR(Sfy8W3cBmymWoU)dFqB}R4cZfAr;Q9DiK>>~N{gy1JWZ66}V_U32AWo&1(%`rf;pl-Vo8H*7LiBtIl0f)Kmb3Lb( zA7qMZjk>Hp2`I0dE=`1mKV`gM*mnO!+OE!L9ds|)tbev0{}DvsvWitjxw|k<3OQ%j zPQNzu$$$%#ymgrqiV~QARxji>kuN{dxzON9rpA)7OG{hO*%0PmcUa!j;Q|((3VN|J z6q=8yI~iSs6>U0hVwE|YNqe9b8XI`frh955r_O!k;*HUAX6RaMZLiN4koTT8VpgK6 zb=yr}*r)9+bCeHe3q{jLEY5Ni5jF3Rb+gk{+bH}ma*B|${6kq@GbO5Mke3bATnEd^FO@nszYDzo5}j+7J<)h| zwW0ATD}R*f-lj#s)=UzrM(e5WCdmgVYg0Y{Xxg@9#7uj5Y&qSVKZa|T+uAWMeK7C$ z&q3^lT(mx#{Nbe7x;7oY|5UPcgNL~=nsHR*NuZiqY$(daN6+f9vLn8S}B5-~XP z)7mxpG2vhH7@Mq!&U(%yYXgA>$}lX;jQz_@v}qLR#=7@{oS@kAF4XM-564!k4|Epo zStNY5xhk6&n|h88Y9!78l9p3eoMhV236O}uqsARN;3I@LdnJa~a0=HgGvcth8g#WD zS(pK91ZPj&5z}c@@_Osv(7tra zY(V%lY7#0~wwL+G`uSAnIyl-Q4#f%&j?9K%8`W(t@*2I!nfckNSFSIKQL&0bC#&jJ z(A@+-THc^C*|pnUAppOccbAxN0ehP=MY07bU>=%-0nMNnv|6i;ViF<-_+btd&cY{enrgj&vHhz!h0~Up9 z3&X0F4}A2yoJ%}D&^VSvX-EiG*L{i`(VOl5>B0YT3@R-C{XRO4K5Id!;RDwxIx|ZJ zV1%-pos>ViF!>66Sn*MtFG%f7HTlW$`os6{9yHz(%B%?bC6kqdHw!V$7??1F&nE^Z z8fm;Ht|z>U$gH`!6$QsHPeSb5x=vjUs@0QsmXezBDLU`QxUX{x2gaka`t6Bq*L$Na z>w5oK<}_TPXfJIH6OO}Lx_u@|rOtv}`yqbYAr}DDyR~1s8by!ara2ph_()>UQnhYT zo*hLOsMv6TPC1P(a-NivpB7FGvi=#F`n+j;lK&e?hUQy6F2xH?UMZ8UtBp|dLuIbl zi6JDq7?oNniCEs_#W?{&qL-`P5jwu5RY4~OL@bLe^csyh7CyEOBP==O%#cj4%VP)N zdT+_s7x_k0MH+EM9M-SRlBn*B$Ka~=q^*fkec`I&QID42$SY<)+o57UXGOf!n+Wnf z-}OT0q$!wCE6C!hulYM2E;j)d3p2`1jw%w; zGfGa@+oyW6#z>@J*F{`@j|pYfRJ-3kRU=YUw<^Mt*hm^`R$YN`~vLn_x~U_g#Dhk-DkrHW=;tGi^9>1Kx2g`hd;y!Itaj{aG~D z$9?{QgSnudd?$E?^pF%1SV>#7LC}6%rxKH8fi?;TK_{!SL~oWCIp#c}T*4G$8ja(@ zfwzg5a|J|*0i2yU?k4pjfpspML?4#w*&~|$=TrGMQFuI(ZgEnVA1@A!h!yb>f$PyM zchu8?mAMPnagyYe@?&TN_2qI5zA1-@)#Revn_<_^tyu?SiTkX_S%#zHXXnqOIh!HA zZ`Roas-NbyMrKEB{29&snbpCzJcun5-wx>u?r^~oHnQh}UhPC*-= z#^^Xu2*=8Of_+4uQbX*AXAfk|Lh{f_+KC1FKP>6LRd?y_%ga@UZS05zT^_K0Rq8%3 zh!uVALMc(+=PsW9_U8QY1iu=mso|?gr8+MIH_RxyZ`bz5Un7!_U(3FVOz_Y7aP34< zoj+zWpRC{Jdr0a7qO@!r@KGSc0dgnpO*+F_3#X}tor_2FJD!yHXaAE`#b36Exmnp|ApT5y_f1d+N&;9c2fET8s9 zHBG#j>J4k#%XX2ks@}w)@ZqV>&&JlRYP~T=WkOML;In}G*&-pW&~$d_kz>%&HPx;E9xk1G*i-i($nQ;( znS2{(yIyb1>N$uJ`_9$#<<*^b=;UQ}Z}abJx7*EK%_0Afy*Ces^8Ne&LsBG_t&*ih ziBJkz#_}!+*^OlwYqFDN$ko!>vj0^@a!O z+TrKcb7#x~zkzKl?CNv{wai`}`xaQDd%khURwrBdeq;1yW+>*=#d~eCB6QHd<22SW zfb1-@kX}jsMash!7wY%~f#th<7w;0o5=5D_BBPfL^zhJcN|m65K3=Ya#a z$9{NOd_5=g;(hTL%s!x042SpMEnj|kOY6%EGM;9+cYLrQUg2S}7U;}u;8>RX=A8V! zE81o}cNjNAbb zrQDXo=W8Ux*#oqSmQAL9e32Q6h0UViiKLc`UXZct!=c8F4$qBZA@fK8D9p*}q?=Js@f`QN##2=c7tq zzM75+>l?ItiMngH58l%Qv4065nJ6fg-d|{#a+TvZ!=g=wRM7cv?{ARtK~$%7QoL$OnczZal z!{-4oMQ5bp9Z{<#t?-)R0!=4HIqX*c%rl?}>K^5o^)NY)jx|w+Wy~EjB6*Wd*({ev5 zrJ~^{jP!MHbN$22XH&E+WI}wp9{h99upzKTt|081kg?sAu&sZ|zC}du>+4p4MK1Ko z(9&cA$9YHZc2;Q!nQsQ#>L{(~^h1RkLZfS*V5Ola*rd;6HAvGf0Zb$3Pp-NMB*;`u znXT6%6W|r^UfRaCL!qnYlfFW)^QvRUh*hC(-N<-gY0T5oI*EtBN3>m5N7;_}`FIs4 z0&i=lTKlb;qXb_)!Z&x#+Hg0u`pn24>*Hb<%C^67zE!_{UrBM1-*>cHYP%eF)VMo| z2Xw{p^>FY`I}mtsYGp$dO8s_U>u%l3xb(4)lC(7Ynl!Nl$Sx1kj#iTu$%Ul?d2!); z@43@Aw`x^WLJKDDO3(O5LH&m=VS0gVJQXsLwxX-^@YW$0Il0BQm&?j9HG^}|Wwgku z&b6jum2;Z5ARgorbVSHJf;%P#9J;@2=Xo2=87xQr^697T-XQ^hi1n!r07ATdfdt5M zm+4A4r{b%bJ=&UG^1I|j(lin#5_C5`2nB{e3faV1EHZq!_P%5wX%OLSYzL_KE3{_5 z_F4}BWu$Fo7b0_3O*)U(lh}@&S-M{loREr>Z-JI?Dfo+23 z!+`#-y705(P>uRWzuvbW{p4tUj@_{!8eKH79!?G2Q0E#X>JJfP*}yrz>OvoFPNN*n z>!ZTlmxuFf@#QhO1KOZJW#;U>zsRFsWIQ!Ms7`C6ER*(ELKg%w&YqVt{3v~2_xjyZ zhXD`x{!dls@hYot$L{&}mu^2#nQM;MPP#M*$ZCaxuWl+|AId_JA^t(?9cSrW`!Xd< z?Mun~$j{iNgo{Rd(kit531G)Nyx|U-SpstW*T2?2n2VSwKW^>_uS$`~uUZH~%Jn_v z-3uHep6&jFvC@cJj&o+}r|0v{gC@@)W5-orni%>k=Cbuk|7CiSh=fw%u z%dZx|M*Faf@$_QNYdckrh}W)zS@%8~4c)E_JVJh8tM>OjF#T=ovDJP~v8Q2K`|PVb zuL@3VE)Ojgj+axb^mUmH|B%_v)BjWKCeHO}RAFp}Qe2pE!R6CyGf^Ev*U$EWYHh`% zGUGYX$w5u$NLX@tE4U_S8w2iQQ`i?+Y2mneoJK8cKE_DjoRa^{t+1AR`3(EE=S0FU zGpXj*XF_RGw>Ob;!02U8ZcGx6`51>VMRTtSo>Js?6>OnWp(EK?0K;YMuq@jo|!|UIEs$PZO6}XC>YILwk@#&#?QmNP} ztH48(GYs9ciV)SMt-X-}4qvu!4Vv;x`!yX7XnqZm?W1C!=<`2fVz<*9V*$nK=B!)% zQB!B~%4zp|uyAL8AT#3r1@*K6nw**x(vCmT*G zd-*Cy3hv{z?#@6Q-0}V)im-4~Ax~}Ge5v%O-bV9gNM08f?x^;seq7gQ&&m`u@L95# z&-eEy`=pBoKxac!Z^Hg)zh+;`%HmI%y8W)OMfotn6(*~RB-`M^>f_xXkIVN(z~YA!x* zA((5D`1H534&`jtr{k)Wzkj&A&fNbtAmrD5l+?v=*I72Eq(>*a^6YNElVssz5~v3 zc5BW&*|m(5e62t!u)VT2fl^A&hhII1Fj2 zC6>glC9hE8?V`^7UU=bF!v2LY&i4c2y>(%1MOq-nj)4O?90-B@Rk1wWq`@sm+GjV@ zKqWcws;kk>XZn9#1nY^^$<*3W3_~3`6<(1+M@_Tl|H^Sp9|!BpPoN^Co2zR(kBkJb(pG>Ii} z=R?qw{YC@_*kcPwcU}vpJJ4JAA-ZPq@x1KISPxaMRhJ`{i5iuT1O1%dh7GU|yzjH* z!mJM<_ztivx=Yo&7l4EM5TS7*#u-}D1h}^F_wjaOLiTkz#@gOpJ|XP|Cf3OTQ%8R0 zFCs-I5QpKs2sd}MVueSk-rgmk!Jpugx-RoJD}Ck>&7#jutzE}gHR z;!X|US&b{T?KP|*lp@7+EfIfO@*M)g93C;SUdzfj!;z=GG(93S5Qj|+QDE`Hznzr{ zq>Mxb#Dzni;XQiG1zj?{QsH`ojk`{`3QruuaW!$Tqvl>Mpcx-}b&bMP{3PLpEwGbB zhxO@Pk2-ECwin`sdU6VK-Xy92($s#V}ug zV%8;pO z;#>}P7LHl;kW-0ufi+3Li?OuDv~Lv)lwSr>8ehbH1a%EwURP1O&EaNy3>2P{>KyBy zLq8F8Gjc2gk#t9|ytuRdz66fxTi&&aLP2VKHwykM= zh157Zm|M@yND;@ZF-wQNVgeii%2M`Q0#1vN@7|uGMqrNLsS9y86adq+-_L_HV#_<4 zh}*h`2DUd(8Tg&nIuGRB-*vJ8&u^fHZLaW~W^pS0pXzcgc`$Beh*{=Qw%8td+LJ9) zKD&AeFoG|{%K=ujWyyzF6ny9Vl$3EQJm)l;xy}hErj9hOE3!PgdNZ%*UqnXOlS!Rn zJ%>k|foX|Ho#fO+Uc;|iKy7T@5ANT}>MH|V9hKnKeOyvv_cnxqX>z6T=#hGr&`9Uy z3XaWefp+MNmQ;;X<8wI_C$l%rvc52vc)xVax-{yC&u4!P);DH@c1jseSASF3#`B)M z-BU+spM6#-TL$Gh$*~o*R^4@!TYyt7zriEz`iF;-Cg$T8Mf%eQ5y22;ocm+tBA}MC z8-_2sSmy{I{Ij!fCuOHK0S|mH^*!Vav0`hdw{jA|IPA}1!fFBOdvnlD!=UasK@woS zQLP2yJLY=jP`kg`R+R)iLx5Fe!Y`fBnx*_k0vSnJpLB)xkupeMbzV*QxJB*7^qwCj^huOsAg0oYxCN zuXWZY^3Qp&=ET{VuB9>(oQH;q*hcUT(+i?^rcOrC*?L-wo|NFSpKh$?xAX7il0N?| zCK-6h2Lk+Pq2K$_AM+^FJZd^Aw!E@lTQ;Ln)}*zG_oJ2}fQ0zKsdzRBTdskLD!pPx zl*pvmWdnP)6v4)8>E463GZhsEci=sTC$z!krAf3aSF+?)PA$x+s&xVM zns^fIjzduDT_>seJErLQGg7vb>ePuGR_wUoDQDdvT7?V7i7ugAEXr-3ox#k4&Naw% zriEJ^R$c#8v%K3bmeZmkLB`i_9VC=wr_(ce_vwj{4=1rr+p9(u#u-EP&Ts#Z7qIDe zR!1cM42S!ehCoLgdMJFIZ^v_VO*Le}coRMH)TV%0^V_9#Kwy0fgQN8w5{oPS+K(RmC;H!Cv2H}?3fHe z>D#{<7^5ur`CC}Px!Mc-gT7@hk%^$=JlX4d;hB*V|0|#dS^c!aGy&m+o0KJw*T6K8 z%~k>b?mj;#1)8_;!%gqk93CEC@tl=hf1-A_$ie8tZaI;j(yAXC%tydhHV_H8iB47? zX8=TkXxT9M^Y!tM2llt0vPdjNZO$NEnm53Vxh#oLJwE$(TVKj` z+CFXCW`0q#-gfup6v{VBgKO~3+mPqZ6Q}66d07H> zC!d}Do~og#^4~wH|M;SZE^s;jFaP1y4M4#yqi-S{`Oj1SUoHrxiZg>YN)=G|)u?~} z>5uyKzNXOb;w$FkzU1`nF{R%&r_{Iex$mX zbXiDY3~#wg6xW>wE4sf~`u;`KEvYPE$IhTYJM{EhEp{hOI#o{XU49T}UTPBy>Wl#` zUIIW|_QMN5{#^j^=j~@9S$?~~@{yS@qy{zt5)i^&JGuejK8ftQ`b?E)9<9U%Rm}i4 zqaRaM*Z(KiHl{34c#&ZiP7vj}zhgE9U~?`||Agz&j0b~ic=Rj*;)4p-0pEg#dJ-+x zgBi{VNn~>Wo21}BhQPos za2t@{Edyur;>5_RxPJ z1pWKGC^|pq|HAGV!Jea-1WDlcgu=x7SS%OpB-Dq>t` zkltHukJrAk^fv&-0e~aV@;`{X&KKPcIqZ?u0rM>ZRbZhwjx7KLka*|LT!!BUg2xqA zJeqf6OtYQ+dCFE?`p*0afEJ{+0}4(3MDXJH|6~wfhd}T)t$;Mmmg(xFo5*P+GxsLw z!#~?FHD?(2X$$Z(`_7Yf*Q0=D z@?VI(|9&wB^-AR$XMxt+8_?chyOjH{n|@Beo|vNHuov)lR@~Gl)vFiKG1`YK+O&a< z#@&kjyNUsm4uz9|wyO-NA$>~{Ompv(#8G}SeXYSCQjDY=N55~y{fi39KQ`5WylI5N zS%!kA?iyFMinZ()lC}Zu*kk9RoOc0_U>?;6;#w(|+)%G-7vS`o?=^qYHyM{Q-Kd+2 zjo%MzP&%7*$z~o7b*ljV#R&~3Mw&nPpN;gH-$vLFValUT3@wEB^M)f?{5y-?fpnK1>a|G0<0r4#>k zn^_W!jw;r{VJ!RG#f6;ia(jc1*Fvb9QHu!8XJ=n8rTeUR7j~-jO5T6@;~k0OR5=bn z7>!@FnBRreeSbKugmVQQ&eM($xlK{8)vAeKKU}!ce5u51RxWxhw?0OEWwMc#yaNmZ+Rdcbr@9Lc@%A^Pl!(Day32H)*0h_rS`!HJA=t z>1ILwvrRvXIv_2Yx=jG!v-V#Q>fxA?#Z;bJyh~fCO1<+0vneL<4Z?Y18W3hXFffr2 zGd`P6fEFThN^IS!(SFFx?6tq8Z6N6u3Uy$Ke|m z&Wd2rW4f3wKEK%`Rtx@gbwD;-9z+A=Z_fojs%O=a^=j7lpxZ$IL%sgJ@12uLqNc9e z^4lnjlFbQ#U#eAot9Imq&^k5um^T-*!Yk+M2J-WkJaTzv*ct8DE#*9J$;4Y%Ny|ue z=3N}~59y9qtOj~^gGZ(fiR-lkt)DHfIsPS2(;+ZA`oASv&?pU{?ce%C?3Q4wASbLQo?KnHQNa6+pQQY?Yy` z{DC>djT!Vf91+m@hAqZZ?K%teR|gY`c8pI{d!vq+$&w&QyUiLYsO8`7avm#r$Lrpq zT))}UoNNoj7I)H%7?ydQdBj*=Pa)$c7~P}TZp4?51T7@00W|QJ+*ilj1gSS^&qrj% zG4ezFH38Imh4&xJ=W8>6(`zL8+liyL;B~JWW+(}Fgm#a}y}gI2x`1F$?s&i5zed$d zKsvkQgkV=9!fR!?dQ$L|KY2zXd3x&u&r65+F#yhnuLTTZq%#+6%ee^)^-8jv`2vXc zbL#-f@shkzv63vFKhaXw<9BSiMsj+|-WQoie_cAK1#}EUu4G=i7wB)*i>eLWVV65@ zobQ2<69@qM6L-8E#`>B#hRcCzDXtp;z0;wM@JunO7vInO{T@sBKTQ_n23^+U_O}TKpD3W`dhP+(TbbQ)r6kNKi{ku>;PCy`NA3!BZ9etl_bibkB zTMf`a>l^SH){Y>*5l!;MWxK0(e(PhHdffzLe#CD*>tM*`u}X`|4wy*_l#cOe9z-ux zz0|xJxOGMZDLuBj5yI5jbTZ?>o3hfyX(HWh_jOhnVhKjF~KfA@_LLCUEYer%l%74{5 z0};>0gL%0$IkJdpvv>ODWu<{_E*j;F%+Ve{=Y%V1?O;d-m=5Qi#!7taP!1!vhP+^@ z`+Fm)04R0IbJn+Tq+Ju%bWd_m9uR`hn+_*=Q$!&TMO-+OZs@GghhLQ_GLAg~6yjjC zMH5Ghz@}C}jbbG|eGl6YB75mq3UmCuvH%2qqstw^$>xC*FWsCXEC8UP9PMyufpi?r zlQh>t-H0VUuv7}7P6#T(W|X+R-AXd({?vf+1?=5#UYhlrxr7=yq5u+DB7f;qd z^}EmgEQQ+-+Af-W(`Hj*(U3I^?YOH2(sk9d2t*u>BK-^>S^FIy>vhKD zTl29tm=-{~Y}vdv{9wg8novIQL0ci!YQ78en;o5SH75u2CIS@Os2_QeVbrfJM$Y>g z62B^;4?0yO6rwrvLjSx_Y_I}@K03Ll)}me|OX6gV{LWlLH;RQj(8i`qVew)X29f60 zG9cFU;w@~o&c^l&SJ%IIbxLqOQxLN5Y%ZN<&4hcHd9}{RQa@3vLA(4mfbv0?FjX1! zDeuI(8T2>dlX1fPSDy(gbAX%}p%LUA!A7x9|Fb$8bnJ;{`QwY;i+B)eI`=zaatG*x z_)5W63tMEF4{z81h{1Ulrq?$N`_4P+JHjZO0$jYXi+wP4cODA5gpDW1^I-S zTGJk=s7cM}sAO$Vh960U%RWdgi!L5sbj% z9xX=L0>KGsy#b$woYTZ!*Dkk{oJB&)gzqSq|74E}wFiJGq*|brDZONptH^b+)TjXG zsOCScraD>PpkS#ENtK0tb|T8%TdBX&ZcavreIGn35y;*kfJno?SR#Kr(22#IfKlkD%1R4%e zwbg_jR|+~ZnmoBbcd{9AH?Dqrtfrj}xHWrx66Ngr>1pQUfmH7nQ}=Qs$k0)#pZNfg zgMFP6I%7kgp_;ro)otn;bhzyWgxKYZK4Z!XS7xoSWxf^1iu(eU3Oq=kO|!MFE9|d_ zas+4Z+y!)VG5BzEX~)r4bgVaPRHQuN2$3WdM4Dvu3;eGH z42+N)UZ~(i{WC}KgIfm~C0!-^K3`|i%?F#78p(m1v~zu_4+aA2aR5JOZ*AfmTQX-% z@n#xDE^lD=9Se8!I%MC5xQWpiHqVLURSjZ#Igmj(_U?y0b}Qe;hZBz~J(qT(Ei${Q z4@Whii$VK8?E?1&S<^4hHh|z>5y$=SV8HQ*c*KkBfzwCS8}T_-*ga`=ti;B+yC04B z37YNg=0z(E0Ds*B^qr-I2RFe(q2-igtw0j9f>%;aj|CV7N)EaQ?;6sD`Fi3#*UML^i8c z*Vh11Z9>s_m0y(ROUI;L$ZO0kEp2RRFAn zLpH){z5oZ~eg44xRNBC7daJ15fwaK1T-e=Hwy}!k zO+&Z<<~Vz#w@c=YSia+8xwYYZjfu_gpRA-)v%)h==7t!QK(C`YFJ;YZQH2Z%a}Fbm zDKWgJf@S{xKpyAJ{kv^}sH3lzxBzW7zvwCN#*2}~aZFzjzo%3_Hti0`e&gS_0_To3 z`od3_*nADBoI+Q&AX{1V9{n&23a~ScKsiq^nX?J&U#}+yRQAJ2YmDB{J{Xqw59m5n zz*bNhASx?>T28yr>p1)CTW?>TgXg+W2eV$PB!QKuN(U3j>t=E3f&JivdJnx`WS;!$ zXGqA^Hi1)&o~UDrb#h+|06LXBwgc@)pF68#f>4B+J7SviT#WSIje?C}?_b}mWahV9 z*(sF}Fus;0z)QYo!Isq(o#t9=SPu7(QM%Rlo#4(nT`7y{iVd1DoNM%GGJ+~TOi(Ke zW=<{?LX}wegWn1XC>6i#bCkNLq%2(G{K2R#C3zi(m=*+cad=q<%PC%wEO8nb`gEgf z%F5p$Y_V@3`t;fFy_*pg+Ok|wJvX&B8?*~%Ew<=e?vJd0{^ijKCUfv%GDnriO1>!CvRr@qra6sE=VN*W{>m>^ zI&tagLBTFiw)0qYb6`Vd^G45A?<>@!?%Q1p<31Zc%I)ToZnO8gJlg!emR4?9Zr-`A zox%Ib?dR797oFfhaiVE~`g7jfNVaILlCn{vk@A@~jw2AWWy-yuiSO~(7lPIi-$;Q^ z$U)tqI-vv{)u3O0rf`|8iwSSTtNO&2GjBUpG>sbGR1MnPAerC-8BZ03S}gjlBaG}r z4|bDNfP(}23_F|O%?1TU2b8v29$^G8b>uk3HH(Q<8H5y9$A$7rI;U;K0}(U(Cl&Pc za*JZ4#SFrNh8x^Evmxhou8|K>7dM9hw@m1J@IGCMe74>Y9w z**lCJy8)HFnNsnstu=UgSEFqP$)$Qb5d$N17MP<)a_uGtAOjz-4NTG)PCZx-)K{hh z*40_9MbKa4oXgifPK3}Y9?soxo2u_CeHDH5s$+m-N%M%Zl+qFaPb&d*F!91lmUFG) zn#p46eeDeV_uWv{tsgGSVLt?ItBf?0`wHx0%Q6^4OI?N=tB3IIY-|r7qxhK2hCODQ zVV?X^9i@C%N{F?3HCV1T)^iGTdMeQxjt4o+Wo1dX2`&Uq=>c@f&Is84lxfgv$S5E_ zuETlk$Wf~d+5ExX#Z1=l_xVh!B|^GUTNxnnDC&6&HXpkmuV)nIhJ7}g-Mo!@iW3GB z6=w-RHs3cN8!I)b0Q&7TzIC_Knylk?DGKirwF1NnlSyfSFE=wFcmbOmsUe7XW)O7` zafS7kUB1IAr;_N49KVw~l?>`7m+w{IN{nlR6)l|t*^liw5`oiq&UpK#GdL29n15fm(K#8JGgr-PrW%OKeCUt_ z3V-O`NYCoEQKVw7LaDti27M(e6XJ{qW?iQT0+iC5wKO>=N%wqc& zbt1{FM1J^<1L!t4Znxe{@lBG}gZjBx=ppxtr0|j~`{_s26g61$ zo5bLXr8EQF<(IzcwIy%8FqtK9nMq$i;qdIKE3dKcxrEO#Hc%Eb=2NtVE?;wRr z^If=W5xwiyoZUK17vu`~gDwY=uh)dL_KXmpCu;WOW<~t^M)t9Auz;aJw8IxvbDZwX z<7G$zKABCy*se03d3d-w_aM)ij(4QwIbd9GJnGX~Xrxy&8xHuTA>LQTFZtqq#Y|fs z{>}`0Nj^sSH&HI9RcOZM&g*AXO=VX(pW~NreuVa(!V|7k;_YTkSETi+>WLpI(L>wW zcnQW|#dj%Mj6ru&43vQo!`~TW!P!}og zkpkm-!d;WEb@uM&9Uk2Zc^(-hdWKz98@XfFrc;&kMwlp%AyE5`Sa}E6=5o8`*0~o8 zeWM2(4NBzaO=p+~B|8|?i*N}M&D>_O6+X=_L}&^zDE6MiP>wB$W+djeCwULE;Wka# zrIh$FB&yJi#%M70q`R)PfjmML{Jp+X3_UdG&21tNaa3QNqD%)dq&~wiAsdEe6zm6U zFNCoBir(n`t7bWi4;FC@k-3)(^FwOwVa(CM~X!b8nCg#U#-X0gEnQc}FNNd}$Hob+riGEW8JmE-lGg9-6Ot?^*0HLXiqq5xsBM z??2=8?RBJuRYgs)5v$9axR!Q+hBClBs=LrETm-(8YXlbRP=}9~%$srEX=6TG>&Iim$-H&hU z9lk{(>aCv;2EEPPRZN?a;8KN}c^pC69p$9HM?R%k2sdNImsfGmL^g15cf5G{0`(UJ!};s*bD>5mEx_7v<>S zjx3#eP{$d|vU!+lo5D##may_nHQ#joq3i&Qqg<%%7!{SlGXRqAHrF0a>(`WqMK^M- zUeRqP6&D22u92=}tD{)NzPkogs9WPEiC;V&Rn7RlSak`8>(UFpl$GQkiZoxFPZee` za^w*8*1pVsTFJ^z(_H9Nsb`vWX(e;O1E!$$zM*>A&0=Q>4aUlJvSEHiq(lxAFL6-7 zXGXe2nh)_R#)qvGuR*lT<@(m<`J9s|tL?R!Z_eU1P+-m?%tX)O<58aC|OPkjP50LP%F?1)jhk1sIa39LZGjYCUavVB5tF*{nnAiQ*@XRP!=6I^$ux^h=pnA5TatLfkPS7w9+9{ z6SC)sJcV3@-sCPI9IUDeJEJok@JWMt--Axl1f6bn^}^jUr<6qz%WKbveGAlg0G|G& z6Qs)Y=n#cDqo4G|caJ9vFO~Sh1eu6S>{VgJP1KVCy|4zxV2gf2!j7T+)F@dR(Jgj8VJkFsPd7gz#S z_xuZ zf{l=CpR8HROm-tce740lHzENEhQnoP1Lq3mtLai=Q zEvkuU)mPIWx2aUe?ZDQ?Wv>e<9gJExnbe;0z5v@SQI9~~a_I%2r!H^ULzU@V1DFAo zqO3?(fq-5~7r5#<5;&#sTsqZJu<*CAcxW$YBH4A#(q+J*(3T0k?AiAjye?BpunN3f zB=LhWNoY|pA&T|P9}^nQ8Lf$fIqKd}yc-&!`lAPO6w`>`W>fqS6o7kmtval4Nar!Lx#tRM zclGH>MtdX)Eqop7p`5bexdo;>yFS(M{xtKTfBF448k`#nK76o0FYeqjL*xfPQuXyX9D6w)j0*uKPO;qp*$RCJ&zAeXyIr3#f>&}aY=-JjOe4S*0rRS&rPC?68YdX|3!*}X8s*fP!p33yfQo){=PUbTz)%_0D*8WIu^5w6r1)v5zXAuYca;Nf2nsE@j32#vfz`L z;26O7ydodt#QS@(N#F!RemK+2sPcGFfy2vpS^~aRn!)s}nsM(QSPdjy1bbDM*K>wD z?*f!=Yo*X)Qia3+f^#{CS!@glmRNSQ!Y9GBw1o3RAU`DToiHgEPaK_6LnTGG*?5f< zlwTfS-J;+!{gxDs!u#?(fY5Phn4#Ahixo=9OBM;3=jlc&yZ=#rz?>}$;J zp#$pxZ~UiKUvuNBPe8Xe(WT^r;qbv_@nWBA&|1#AJaZW{kEh5a6{D0Ud5Y+x)uQ&b zu4Ozd+0G|ujHn@+52h=RY(B&Oa(veJ_ph)Ik+ykBQ^=Ms=4GA0qs}I)m(#FESa_Y= z{LxFM0deB&1(D)kgRshsWlCw!)a$MYdeZd$l(hK{-Z#E7+LDK%aAh66;1HIJr(JUo zna(!0lg@E`F&~}XoK8LBnG0m$cu_!$wSUHqm^K=I#X@08^Wx95F$h9(b*is6si~nK z79%hklypzB81o;IT4L`Zbl=+MaWiSc&%hx})p7kzmiLs)>$B-7htJjQ80iUoOA?(rG(jE{KIi7GCuo%AEzGAkSMNMv{fqP@#OwTfXnW#0 zK^EPxNklCJ!^{3J3o!2HA5QM(y%sgfFjv8GONELtJt_YM_SAUv0!-9xG51Rm_!^RkhLvP^|R|wstD{<>IofDbAyTOq==1>dV+0h`3)?2V`Ib%<-e_BC|!NULRxqDJiWRYX4X!WhM0w; zrJtM!rw7=9pt1xzRAVg04y>-`;9A6;RmN8Wm#O57PBO6*;}^ zop%*cIT&fEf>X)~L0qUD((H4^tl`6r8pxAQN877rPiLBMYshMi{u*IK-t5h^*ac_j zD&-j88NTifIg*mlVQlsZ2#qG1nC5_FbNs*k}Q`ylEb?3j{Msgw5 zZH(v=ZB$e&{|G-PilUY?t2Nx5b&C-ubNc62P?PVPxZ-jx3ynozzp=<6)WeB`GTGVE zb^PE6lct^fB=i0m_FKr7@B{Ry&#iu=;Zxj#$m33yx1Lk;F;>L7T;|@_bdh2~B}>H{ z;$tjdf28h$+7ag3jG4aFEqgzFncos{ScJT*N~y?WUEiZ6MSe}>oz?O(X!D}`X4=Ja zC8_~Pxrm9AIG69o#(1`Sf;ShUKzRhNq+2~cp7AmALqi^tFs3*jAGb}oj3<6Gkl#$_ zLmJ=Fs&H>^p=uCT$F5p05D#qbG1JdAyaSQ2BZ`xu_+<*ps{Iy*i4OSM4xYH0cg6n*D!$^GJGcPY`j^lHlU{YtrHNGJ1w6(a*^7zgrc;O3}f4v}IJaEr&v@d1m zjFG5BNes+tJC?zuXOVDr9T8_J!#pwRBO0c%n+}N(nKMM6{JlVaLgpS&RGcsrYNnp^ z`Jn!sys|AkD`|m&jTH1D&}WuWMP^N*x29-v4gt(X5jfM148L0nx1uZxE>c)zzY8$rtIY zI= zuC&O!N~_fQ=36uOVVQVRk>GPUVRsu&t33FAEejJd5EQ&WDM55C-XH3Oj~ z*LT-!E9|nYa|%F3=mHMLNpJR&4503jkaZQGZ7ypX17vvL*K;@SFTG1Ou5dO{OoM1~ z=I3pgfqg4oU%e?GXLqsL`dPt4l})h_l_)h*Y*SbsW)K4^={csNt9zEXXvAvLnfl)V zET zQCvSu&g)4N)nzlx6dL$P1%1dH>1+PS-D$0WZF&W~r(KT`W&W*qB6Gv%;W=c**w6|B z$2ApDV8!4S;6r_K;5hoI`xsoTH}v+h*iHBhBXI(@%?Dso%NGbGYUKF z<=N^LXse}eKlWC3owMGN-i3;PJym~8*hjX11QZmAzajF`NSRKZ64VRSrf4*Mx_*k> z(wE6apsdov<8en$;MSyS`x&8ofI>;qTj&k1T;R6f*n7UGO1*sRtaRCUjAgL*o-9%3 z$7a#ax6<@lc#*U1V)+*1V-+8|Hc8JKTZ%ak^#I%~ob$}*F>7OAqWQ=} zZQq^GJx@=bO6Vsz4tq4|Yxk|jnAq4L?`N=c8gN!tqU*oE)Mb%D3`QqTGl+s;Imv^K zwsXVn+QLx~Qr4TAH=-9oYkK)Zq;NBEgG{MXVrH%b+6e>8}2dORUU0U+Ba#qb*_gX5b=yh!45ikBj3%5qy zSo6dM|n z8{aHFM!T^`duyzQJ_B&Xw8~7HJ}*{eZ?rs`{p#8xlGf`p7cxP!z|!v92r{y|%uoUV zaIm)idA;s96FOwYhibzTiDmz5e=T2sRHIk9e$TQ=`iYVkq~#DglG}wS@Yz%_ciJth zUdi2^4x$CToE*JlE}g=B~=zUBqHz$;$-i)=xI|Bxq*7Y(u*&X)^(N0*`9XNoL?*sEZFVm%6C$2d?0?ko(bx8 zF19vxF^UDN5|wT%PGaZs?$3hh1p3E?H32h1of;fSjUp{Os!E6MI1#>=UnUB!43P<5 zif%b9^TKFMRRrZU9C1b-Hd>E9xr-!F+zI_oFJ6Dp=pJ53CP<&b(FJx*%BetRc-e+S`EIk56CBG{a_JcWHe3TB8I%X zD5#-`1QL5kZ#;P^BCL^KvvUkC(&K?=Wi3=B$)cXpcBmSrsd;|(J-fBc{-*c4o^0+u z%;)il$5YzXwp7puv4o_^h-A0*X~8v7I`4v7ciG|zP*T5CI;4sB{P^G)VL-Z*EZ@bN zk*Po5qit!S=c;1j4WGzSP@M{k^pj&&NJ=!hDR?J#one-VgN8ki(ct7|T1lw%48fOY zD+s8au9r<3B;#B%Fj#)qR!qNA^~_8MY4)f?F4J@E+Z7Y1;Nu>dP#PVi1mJZyGMqu(VOd9 z&r0O;3SDxvVlEYF$3f!kh1k6cG)v88BB`x{$>@HBXC;m%K^6y$4VYHB8zQbSJxjnN z-w~{^nDg0Ngv!1XL<9M=8;(6Z+8iM<_ulbTU}roSN@;pDsz2!Ke+1e|j+ilBv~;E4 zuoR8hG&SEMRTeSJGwV6$gC+hS_PO)|^%_$#%>C6InTXI>ZRdRHZ!oECa&Dw8xuVgM}-ff6>C#40?#!L+kMK-m=%<=_4iU}vb@<#n)8$P!D+ zBbPoQi}9P6Mj#5sLRswQd~e$lcvS5=`2xO7QLYM&8gj5_gOgtFab7 zAy)UZq(v=e+l=)jmUfW+aNO75AKg-fB`tn0gX{t;6D#@br=-%G8>;RWR^&Qqr42*e znbOcS{@`1RR1ekZDn-RS<_vO5qilD-Gbz)1+UHJ|hF`6RoX%SKP4C7?kmZ(MjaMvorYa5WMzBboQbz)$p0{r7{W2No>uxO==PDn(TvTP zXTl}=4pyJ$8?4rG&(U!B7!t88&W%K8_R;OsXPST%9rW?<6A)d%M8Gz84fdK2PfS7{ zSPo=F==!D^s>0wZkrDc+U;ymNIf8bbl{TXI^&n4pD@uJ>jj@okF^#8C! zVjYR(4tnV4iyV&oX7OIL+|@hm5qhknTTJ6aYQsS5+wx$>qqO^7F2c}nzYS<+G6676 zvF-sntc#{9w&7s;qCxiu+3IpYyPGcqU4EuX-Z=VBcrQbhyjjG(2a=ckRT4%3;#M_I z^1g-xp1l_#wVs!m$W*;7IbcILY%bIj>mee|15yM@QY}QF;ju;`x5O_vC$}qIti!)c z?}szn-dF+f7YK(zWF`3*zXPj~wRP25OZF%Kvue5{nGyPCF}wNY z@~F}V0pEx^WZd2=3lS%qj@v1H5<{W+ka?L}vjuN($)Dg^!b&OHw!>S!TU_j^I$;yr z;f|wv9C<;b@<#Ix!f?q$VtLG^8IP%#Owe*a*G~F5?nG*BtKiF6pp5#qjaT@a>8uVj zq1`uIsU8MmrR9*OwNKwNLxLyY#{fn6NW16)GZ8myJHT9;m~|f+m&t7~cQdyoFukf( zJ&(VLt)uc7u#5)5DDr5_W85Cz5xa(vva9+z+C+W-r}iO#y<&c$7n9p<->uF<+n}L} ze#J^Jx2CU#52*_^p|+``Br}AQQ3ZuHs@Rd+-m=?I#J#PS?GQ z8~WAs7u;4?Ae8Kv*xtWlyP?kdf%uq&)`R8PaeLr?ko(o0sUPR)kjh;ThkHVaKGe3EW-=-;?Y2<&UbCa zFgD%MhCrP=D<^z(&tZ_mUNpl`bC442w0bF9aegP3K-TeZs4+Z_4i=rE6VQD6k%# zeY-BiXBvzDXsl>|9NE!9)7K(oP36{rh8PXieeWZTXWlD7(ds9=DjXhRN>_z4zu6r} zEMt|iN%ew*JDhQ`%g5m*nSeeOgTIqr(WY3)FuAqi+<6H94xNEaP`=n z%`Cj82*1S5hh0+k@NsMVB6W%Pxfw&YJ#_>CYj2wUL4AhD zfur|?yiTWd+8Lve19;E{B#nkpt$0P+6=Ty*3;Odr`32HC$nkMesGNM-P z5j1FYiVG~0@MJ%-0Y+?e{m9D87c(;4@5!MdQ68pQpf#9+$Wt-Uj2r9D_nvR^ZI~dI zEhri!pi%cE($&oSq0W);fgz(~id#Km1xWOv1nZ>@ww-fRoZrz&=)|oU`h03}FI?Kn zi)+Nk?-O3B^zrsjoZ6}@|Kbf>{BUhR3TV%K)97v(J0>A=&=T#!eAkyfYmczA&#a6>a$a-?_<%d!W z@%4|!T0O;nsz+Y6=Fcf#Th2DVVPBgWh8qwXCkU>Gi5;%;t_E7Dvs_afs{4@nRBf}6 z_$wTjc3tc0Q4@QKrAeu#^?BN9%4I_7Vul9Sy76kHnvrDVGxF3(FgjPMuh0JA4%h6f zQ`|s}m4`Pv*kG`ZX4iA5uHX!hK7m{Ds2gI3JKE5XMB{b58Wrt@Ys!*Z53|*vO7G(G z%la@ckrAd-6SbQ{yW`I@qS;oj73F4|$XtI!LjRgF_CuEiA;jt&(+=AQB!?b3Wqr2l>fXDrLJDYwxNo5#-u~B0`X!_ld&aS(ESs~p^*uvZ18o%OowEc?ra zq`iRE-oEKzndUI}{^Ga>_Y7zRTe{*Nb;11Cr_{Vkns3kK-ZN;NK3NichW%LYo|l`q z+U!5xkzc|@qUJ7Tf9DYX?pXnjOV4}ldUZTIA#45u@eG#bj5I48GAz4uB7>J&@1W7v z*ylpHy`+R4c3V!d?l;+~REd%WV?c?cVX=M$uBExz7G%q0@(c5gUJewdm$d|cje7f> zWg%GqdZV;w3*IWTrH*^AFB=qQ;0d%UAeHf{6&Vxe`%*2u$+Zr4r%p`8JnJf@ym?*5 z?v=h=^A>^Wj20MlV+-XAH8_raS_C^ZdJ1CcMCJ+60gp8hXdnqMs1`sff36SAM&vBH z&Fq}8y@=~g*M5au#Ea1}W@VAQo&e!i%jpT&eW++`mvhlZeK()ft7=_2%w`QEFKhi~ zXD%K!PI4zs!obWW$5u&&J(pgd%}AOfZiGYy?;c6lx#Y^mzROht!arU+*G<9;T&ElN zMZEp;z@zK7CQDS5<#@T%?6oqsR{fTwa$Fq|suo%3>iqHE z(rx7%aOQvKQeUQQ>T?Gi&!C{VtYS}%F#D>qUWK9k<55i-*c`SBPGuaZ?Tn%O8GcP! zbFaX46qZr4R!=D(pN+yzIiMZFvc845^mQIUgZySeO-ff6ufW?v&{V-MR-|+xKSKXl zhK*YWD{{aQNy#10FgKk#mT42lmQrIoVIG(qDO&DRf{q!{O~5C(Ha=cz$N+ySQ5pdz z?*x>@;zmh_6a@9n0yDPiIcxO5c|q7+owYPge1t~Em^n4RK7O=mNGQWO>Q|8YSG9l_ zi8>obb?gw1O?^mP;oC@n3+X>|;60yc(Hn!@zz4JVWi#Y(Zu27jBHIZm1q7#l+zY{F6* z)FifGtMd6rljpkU?OMB+!HucQ4&=*ew?fp0yvaZ}yz&5D%*h?YOyk^m?QWj2|86~EN@<<5uDKOG+AgwDGgNkJZby>&*)2$&VF@qE;_@GW-pp$D^X68<&U62EFD- zg)?E!qYh&T~ny1rTXKW6s5C(&>iwYUW!fBo_ zD(NO4!|v8)YaGvZCs{oN4%CB zml}xMJ;m_OHXM+zzjvPNN@`edY&{{&eF9H^;Pj4aV?(mEd%gE^g^qXYg~z4da|P;t zX>ua&Tc`#>t_X&ODo)Pt;#N(&M)2U6;dgukcT2U!w2f*U{O5#Fe?r$VK zH!9qp#yZbkT(k0z} z>OU>zcpSbo8@FVX@4+_zRc3`<1*JmmVLhk0xg4`Fij&H3$u&rw<*EcNYncdYGxyck zw)?0&V=2sH76A-N{EU$DjVE-IX{{Gf-pAUi>e(KK^8aWrb%$ z^^BS$=tSg0F4FZ{mxkettOqihgg(lUL5IeQr+QW}hJuDrSWEgmQcY~>j>~MgU;?IJ zqF*6&9|8pJ6LZu2+S6+sTYOx8Mn5@7_X_;elK<&T{hLcDSeyg!@Q*=Zsb|2rwRa%1 zwFi{NsV4Wn1(FL0dg0*#OulxWSwykcM8C(Vx_P`0quoaG31@lYFX>i5;f!-SU$mi_{PiAi93noD5$ww ze{~;MUj)qD;%1EA1k>gUC|w7^WC6RbXoa|wICgb`bg+KOf)0H=hGLgR`61Z=H);^! zCI1&gq`#W2BqQBf_rvBhYp(!3c{4D4+!sp#a8XFR`kmQih~uOINA7Z`oPM?FRP zN_GC}=l|zTzyI}A+o(Sl(MXQvX+PkE%ZtfR|5GPV{#!V@Lz6UF8h_wF`e`d%rvvFmifZW}^82YAgNv zTvYYx+O3sj{$K2(|N6&lPHTlZo#qIr*!Te*=|7-pKG3ozhA^(42(i!7p#S%G96o1R- zox!(am5ju*s?%k;_ILK;{_V03LxZk#^-mQ4i2koF_+R3mX&!KaRQ0ng0)J=OjnAIDa4zfd z|7&@Fzl!^6Al6)%ak@tHUw+i@?*uClzzvq}mC7yhzjGB-U`kUmc>O_W_<#9Pf4o_e zH^9<;W{D>LJ6CbxG}K6W(6;>zc2`Npw_xdvW552L++8yGG^S^YM7+5DSC;e3bC+bm z(s4ig`KxB*@9EVamX1*hMCpIb`G4%@A9MbLjRgE-&VTR(QU7@7KLn3|yz?J??myo7 z50>#yvhfGYI4yntlWhE+I{lMu{4qcMC)xNX+4!S9{QoG~2)IRcV*`#m?gy&jZ9r!_ z(yB@q2+nh1fE;8ZXzPjR)-=j%7f-O6b@ToJ@T7md_3$Jg48lGeZ7zP& zv9uj;SlzK6dL5m7+VJcf;&J|bz9Sj*iy&im3U973P2UnS5Cl}YkloceCHUcbLl2cj z$~yF7lh@C|jvg8esw`$1A^Uqz8*;iEYIGa`eq;RmT9- zi|vSw&5ra0x0Nx%3MLP1W@L59Ev)B&18kDhl zpXbDC4a!ew3%XWU+X!?{dw9~%|6dgjig$FZn}A z9(?mBI4bt^J@FZaJyFVfHe)J#z2)PxxGfxjYU5r@zvuLw0suwI3X_hA*GubxIxkVK z7!EK(Z!Lt{n08q+1UiIz8oaLK+%DZ5zK`N;mPf2koY#9}SygAI21*M&o7SqQqsMwg`-1lye){wjzx{9r)$q5FrpQX;ig2Iu|)ZstC6?tBwP z*yeG|{--XAl=OmtBN2}!>dV(02Obh93AJy1qgK`Sl-(N^yvuD>X&-VIu;+G>GMtVGxS26+kGaq7(NV&$X z3I?DjK|J%J-CP*V7l=y)q7An=c>7qpV9~JL^iARq^&X{^gwc;j<#XM=cN`X9vX|6O z_b(ttm)#~#y4ZPFpQzsl?OeO+6+g|TV&vJASvLf_epR#0y~12UVYYptLH&zQ>XFAK zf3|4slmnFJQYQV`^~PCu-9dVn%m-IT-H!7Hl@e`An%ER0#$&J(77V-|eYQ~Z^ro7F zySZsP!=kup-jhZx2ZOXU-rANqRV94NDys#L{8Ibvxp*oO1QjwUbwQg89@J=!AQU3}Edg>K%{!>1TQY zf%!Ea(Kb?~6T}dH*y{j4HgCd0oc0#rCw9RX`lx^0EO;O!98kGoj<` zAG7H{lxlwWw&Sp~_v<^(RJ}DQ|H%Q3oPpS&UT2)?RrXj0K=eoz1dcPDMi2=jJ1*#2 zg6u3O29T4#&a*W*aMuWOb(AK#bp!X~Ec6{)O=(ks%@<|7w#N6{HJ;a70M+a^Mj=hK z4a%?*&bEaBN(>hKfFz&KZt_bLs@yD08}PdqNxxH6Jrk&FG1Nnt@*OmcH|xjXE#xEv z+{9QU2Az#6Ft|4DNTA=~%5&Do?>6~IvwInSWrKz&qm^N zt_>i4dp0N6k_wNlfCwu;u%BX_P>sVi#&1I+=zA^>#|S_pmRzh`bCBNP+B5`ZIL>Jc zqD;7N)-?{dLot_ZtCM=hCka@+NaC|!6;Jvm3VrcXaGAtVR*cP39-{dv%_tf_-3_6S z<4*V8O+2P2o8bm{3We=U7eA4Fho~rT$YjZoiNzNgP>u}w%@=8ZqL}zNJd*WrV~>Ma=kC9wzw#w~<6vvH*JzGKH;U0UHcP=V z0H>J1*LzaV;TiI$dS!zmV^+u&Wh|OgJ;DZTgHEi1_+t3(XI9m+Vfv+scLYxD(>HFDHI{ywWC@a8v3E`Nyoo>=I2g z;(&G?gcZL{5{-SW_*fC`uz&;7mY#Z}42;MmPLzG8aT!s00w`LGX6-Z?vc9LBvXn^P z$1Azr`RXrVEkPWov+YyW<~3y!+fh!ivoPqQ9 z#)6?Q@BHTtr&pWxO)+ElaQ!u~?4g+U5;OCHUM=0Xoou}<}c9XjSz z*AGh*6(Rd*Xa#*G7A?^XfBQYKF~gW7Zp8%-xOhMHoKWrkRmrl3U(q(JmFHHeiz<8c;YLew`GL=ktj> z;VbG-;OVC!^LTs;9r$tHk?sw1tLvZK9)Rgk(SckQezGu?Z{}zJyu1Vh#X|7UX?#8b zNrU{8BDo;lMk5YKXo^Al;Cp zVSxeuI&1-z*<=_Dw5Th*s&F*v>HM$!?^-4VolgArfoBD0>h-T$rv^o{)}md!#)GN1 zj3dQ%`N(&m1AI1qnQr=Z)^SvuKVtv|Bz@2)FCXI5WtAks7ja+ZrV}xE|C!pEQ)hBT zA@|3p>pdV%vtiRHvNVi*@WXL7IIXkpaV;wriQu}$!dM#%QL8^(hbHkVO8CZ~r6cNo zmyD$j&htob0xq>>&dp&w*TWEh{UuA|lQRM5fbCwU_4!j23E;c(b+Ot1rK?`0Wput9 zWbKuqQxJjO3=aZPs&>MEgtv(erfA%5F{BImY$v;DnhH&a36 zzOC@D0mq87%pxhC%XstRJ^jga_;JYE$)T3R%b6DIruGm0HqYZ%v7W_~JCudqyWi?Z zx0J~DTXSBtIk#K)q#YMb)Vbv92epUdeuV9q?=180qQU(BPWx7|^@5ep%+j#o#Y1%g z6l?AXx2D_L53b>Ungx$A!4iAp?9Ew2KGmGpGTu?YaRHcPUuC4>kC;e~XVYKND}W5i zHodXs^9fw}U?_Fn2RH@J6;3D_Jp&+Ov>pK@pa;g@yPxPp=dW^Pd4Xsw03vzW1Rqgl z@U=Zu`UK4Oj&9oizp_1PP05)bhQ11dE^TqCv(*Pml{+hAL5KQe$y|dT*XJ7nXMOO2 z@Qm&$a5g{-M4}h@+`n?%;GG=;f>s=^!m(_oR9$gg=mj-1uMgM6;6D4#Z_1~5mR3d! zR~EFFs}#Z1bm`iH)J0a4$tt^*{xCrIsOR48ralHJAZ0}6Vcj)bf!EiIL8|elE=Skn zQ2Y9X^)W;0U8TeyN<-X4l+~6?&ZOpTR)D2SC{3+L%x#?)D zuomw!3EMuTl?d)LN6^tI!P7@WSZwLD047MRMm|=wI~d4G%g}P%J?+0WlxWMRF&4vClyNFzC$C>Sz#sfJl$I=fcmRO$ol{e}I2_eLyKXE{)@(jC4vBoU3g5rb0q_b?;JDV>)o3t7+hvGS-EuA zmPuyZZJyt7$9hyAM6aW^jz|VHJkpOB=r3h`yAr>gqTK-_+kqT8btJBo0@fmqMc)OV=wb)`BbzX{ti;B%GTTAP@4&lud z4};qhdy=yVLmwxREFMVKu=wGsNs^$Axj{%{t6wO5SF(M zZ$1wYleRTE0n%Ro(k?BdIX~@-mFS_$McfBf6x*TVv9bpT9CCcGQ~*b9a<$#$9eqt< zvpi^@&~AVy{z7~ho>VUP0YJKvJL`U=@aRpaky7DQ(kDZ>%9)^ z2hc~g9=Gkasi~eskq#f+vAZtMO!W*?j(XvH8L`W&bqi_cRS4DQpPi~l&u{?jD+scF zA5Zbo6@1i3AW)IasW03RdAT%%-Z^i{d&SOu@|r{9G!cPVv9Dhm28lmSHeE0ru$d<=tvd*5HEy4+&Rp}ZkyX1%50r0jagABrlp)Kq z0<^Ry*r+T-exV=Q+CQ3$?Y(Od_C-nJxF>HEHgwJ5Y48!rg{N(jW=p=^90pOHdRa(j zP*Cx30b*5&yfEaM0`+3+YY)o$XsjPjExvrjS8NFPuCgpq{q&-($3Nu2`yrFv(as!% z>E6GND9S$x`Fwhh$we(?#1rW%6D+gP`&f7{P;Yv%tCs!U_T(51o$&8{yz;chi$sm~ zfusM@^c))oU{x1b((rH5Z_cmO#GR^!f4TBa_=;SR)t}DiQ5W&4aB8Z>dFo4E@rW*k z*}fHrvDJxPE^4jf!zULQ=G|t~8^)IG#dMl5ahf-FC^E7`b;%4f($0Puz8OOM0$%7H zX%o&Cef{aiklfX*iiv(oy@6@b%{>zt^1(paxJ7o&;w@%=tD$jlR+2Fr*eZBx0QZA= zp<&nOM^u&G^u6D30ky22K=NsalGSM@<0b$pZYwnHFPSDc9~&TU@k$jopuT)#qk{oQ z*<)YrfU?&p8mH&sIB1Q?BgOzVI&Ls3DSWV)^@E7e(r@^#!cp^?sw6nbCT!ap=0CoB z&NG0ecO3|rmo5GAQMZPE9)PW@q_x4xHw(U)ZOlyXYijh^@v&=~X?mf0p>@4SL;D3P z;d|N|^Z)WF*>%lA3n_LbD{gi}&+VsnVf)(^{f%cjJ;H;(osWrC!h1>W&Z<4+F!5G1 z=U?NiJ&C*spQWmDgtE|R<4qTPSXJcUfKXxr*w$tSsba$yOUrC0?$dnn7&i`?`1V-@ zT|2W#A9;F@?tpvr?rDhEpY9RBd*2u5mUOhXf)2?tPd@8EJ?-im5kDjs+g2VfvC}Qh z^TMKmT!Ho3l=`(@vMC^Q ze$J7uGgeGm=+|I5?t6B3uUk&q%Ee=K{CkzwVV6(ClCG{cRBL}rrj__{O*_}B9TH?* zf+H=O2JDUD)%WIL&gw;;tDIb##v&WOp9n{?z8vfrLSV$Ue7J?3;EdT_a7OBMK~sE! z2jv3^tk|>F_Q!+viU0-{I%K}KJM|&WRk2u`JyR-KfYNJbLL!A*sVI@!Kvs&T&e;0J z++Za*K__<5``$sW`lKWK*oU{8%N`FJW*D498b*uRs%-oCYA8MGpfh9|y9Z4Qwxbre z&BG=BH?Vp0`W@vvkPGM5%ib}`O(F?K0wsl+s`7vc*zB62a9mhv`nzh8(Wiw^ApPawR8#o4^U8c>68~%;;w>0c z?gZ*up|8A_NAl@-wqL$aiMw2G8;OeI~WYpEto&>9=lLMOyr&*b);W#i`yqFQViUpEY(K%KzcXNRDmivu2 z--rqjA?Y4Rv?WbSJAO=dD47|X+b!u19Go*A_c`!*> zjpIalND`a+6>P#~y{ErLh7O6w19SCg$mEgo&=7eZe6b*-9?blcGF# zc6k0nSdoe&U7Z)hyw7WoVlCWU{CqMQYJAoys|HnBqHEvODdFL_QKETTO#S>LFJ6GI zp-$m6Lj+ZB#oBSOS1n*4c;`CY?m$up(@9Mvtk0E`r9m6Bzi*!&YLKh6!xCWh6n$_7 z`ZSs3I-4gfhc3>f&hsh-htAK`+qf{nsnxC(#py>p1iv(M0`yswe+FL}4|?yz|L?O< z(A{Qb{2&?qJVUi8sq>an8l?s%fHdg-cY*vL`}u=eSLO$MbRk%t7-l8e1cx^7ZiS_x zk5}hqYckLF6?j({zj~`_sova|vgzD7;a(qXXX&dl^~&r0Jp)sAUH<72{}AGT9aE+3K>W9bYMe4LM zq`mcSD|+u~O9hdhfpwjS>^<9Kx^lg*;tlRsnD^cXQ&PO!nv`5kaI3MRL@PvfvC5ez z2_rdn4X;`lL%iZv!zei}R1~}x?QRS`4C7k5bQ+i7C;Q~Xb(pxp7#AN6rh~81Sv{&s z5+>K~T^6u}BKH zPP;IAlb>P|`K+8vUgB4BklacDV{`f^2Q>DTQ^~e8qur7pvgvPJAyoXLyIX~r??^Vw zEnLBYaKhA+l}K`u=i%-PrtqTl2nj8 zk(OBYQ&`|s)R#LlIUnP^H096`$zw=)PwR%Tq;*>;)}*9WVWdta*ZoH`UVOafZ+`B# zYP&ln0D!v3i}kwS`d3P~fm@v+*1KkL(7gGiEZ`-{t-ROQy%p|V4u{2m3Cp*DV4rh( z0!m%-UCSaW+g%`vs*f#b75Qp=<*pc_0fE?{Jn$+f%1UfLzW;N7Ua0JX5C z+6W1gp=4ofK70h~NU`iCH)i*88nHsszKt*1NO;+Uk%rt|Koz#W^2lyFXqZ*Sb*s=*z4OX6LuCO96;2wSC=|Iy!ydZ4ie zM7yFTBI<_F6imp4h#TK&V>5M~_jDic(yQY94yHadqugK}qRF%GAQ4GpaIjk=RIxR7 zp({TpDi#tR-YqdHR3bAt1c$idB%kHys;a)rqU@)$NVb8`hbuzSzh+Fa-eAqUj!Vy+ z`JY#m4bGbPrmbN$ylGflS*5ugv0_+Zd+ke$7q)wSp@$jXkvp?537rq=JSg@QAZVv; zEnd2#rRu4k?Rky0Htk$2|G^JAv%_7whp?h`7YWEVQv~Vz^XE5*>Rc>3R{D~bj)>~9 zomN&>VGu{HYud)ooy_%rkO8%ZCmdgI{phVC<4n0v0HIS^i zd`@Pttve)K@Uv37INg9_Qr{^9E@>^4F)%0B;w;nGn^86sJA=pV==zmXyxf~LG#w=d z1dJy>2t!j;ldrq}+aCNrhmw^?^8o|_x!C>cot{H8R%PWL8@;i%+f zc8`;Nu7~G22fcby1xp7e*l*pw{SkCIm9^b^vm*M@b@bN=mIZxpF%Gauqn z(_XTC^ZNCrncD^u1RMtfhx$+|i^IG7K)LrZ<;q$pr+Hr@&G?VJ2p*ex+lI^@$P7;G z?%nqCNOS6Qrpa%9{xo;)psVSY<7#45&Gq9#$*0}vKVHzT+Zoe6$}vXRaRUWSmF^YF z$}QlRI2Kv=4e8>c48hh@L*Xkzsk%|s%AOG?$VN>~Xf-J% z=ewe!B7b{d?D|YOq{`)6tbLfv>NwBTCP=DT^c&ni+2#H^(-g49ru?Z9`2hR71CN!# z(?2?`+oJN(D5#{sjWFggN-l~S%4x$T6Wg1Poo$qdD>B}f&wuGaMF0FbKd<|BVq&7) z_?Sq$#?QC;@UsLKwJ`S~?Bv@65&cF|K7UE=t7^qxy})DIz)$0 zp-DAS0^0O8om+*oVf#wDJ*XhQ$JD#Iq=az-HIR)*=`Jw#Z4aXsB?&Lh1rhfy<&Do_ zT%F*kf!V=|*Zv6Yo?{?CnPDb_CJPkzmLT-K!x!IEV&;3X;-kJtiN+H1T|5@4R;DLM z3^OJa^KvM0-^aYf4>&0LllXPF(~jfX!s1_>k2$j44kmZ8zNn+iBHAJBww!>|o2+$; zS@X3T^UstD9X!Do z&eZ%i;`~ug5@ouB6|i}TX5rx(^pUH56huNO7I$L7dWnvX1M2=v&MxdUEc(H$f0UN85#mP+(jwW3e z$5da%4sSS}aY&A&_l*|a+K>_#r>2dH9ceyVnrVm^HMQ;DXrnX~Hc&y?*N|Koh;jXd zWPNJfH(h70c?UAFtsdGUswR z&%v?lBF=Mhnj%E3d58)7hgTLgZoI$B&jxZ%HUi=cj?=;qYlzR?;WlcQUr^hHl!AV7 zW%9FuWvL}0YaPFi<})UlNFMHHtwpYZ|jH=a>u#44sb6e5RLAJ>ZmlX2VQOon1ZPxA3N3s%(d_J{2iKtpC*c}KyUcCcV>{+= z+eGja{fQ>uClBrQHA-}tsHnVc`;=jRdW`DEHIlXzzRkVl-$CV8n2=hn|Asdsw(Ok+tV;vXP7a%*#wrluXn2 zZR$_qpUUlPc!aX|U{eemKB;D`9eR3Pin&l}`3!qP(yyUEZ!)Ft1&cZ3c3#@kD1CH(YGNi`bGEBrblQX?GN zSE@oNhXwG#BK3=uCYv~ZWiz=c!Nt`-&FduM0#g2)Cqu2dyR~&mcW3t^@SCKby?3$Blg=F<#4F-k) zgS5u<$S7OYNRI%A>sK&Y7t|F;b1+m|<2w~k|3oms9fBi5Gi&Za%MXvC)hm;va$_HGUeHj(Nc5t{Ak?qMy^4o9E+rVbmG zeIjO5>%EnDQBKR{X8RF4Mj(+Xx1DfKhZGMi9PgP#PMY5uczYh$7FI}b)Lc}vgI+9U zVQIO8`PaVQoC=tc+S(hbv-mCHZ$!x-RV;Bk_> zo3>LtyhFUUQ+i|o%;4n9F<^l?^OAyu&&WSjDNU5s8@ukdI#cUp(&64916^2~h_Pxo z!vMlS(ik%TfgLlq%e-x_YMT{J00A-igS5hMGU_`AYqK*q2m5ummZ(mk@Wzg9@urjd zmA(TzpPBYdbA>~@E3SoS^j&M%>d&oJj!J52C0qb0{PIW!BIt+9$SR|vS)#O&KatKj zY^Jooz_>Noxld?8>tb?D%x%mNatwfT$^dDE};oo}qlgBbrmH#y zPtEI#4@9QKEt~n3ja9Q((l(e>hK7gjDCzVuvhw%#Zq=r(phfjpd$=iDK__sbUahG= z`u39>-r4;I%IqGa7;Xaf49S(rxeU)&#*Dd${ z@VH`gg=KXFz)e6j<__tps8|8>d#9$R#>Fe)ZQqTqL&Nr#MLpIVed2XtknrqWi=TxU z(G5!5Zxc25py=Kzi!qey9 zRf+#BzH%BE=w#_vO80*9?-E9UGppk)86pgR{L?MEht(**b`BMckj11hIJV6M9CG=H_1Xahc84n4>3crXbH&-|vyj@zC z>VJE7y$jVe0^0KLVq##0LVuoo za=z3S**IZH*}V(E3c6#IZf1-v7o~+lNZKjr6s0MZ^$+uOcjV;cVgRtXF4^46?2@D4 z(eB54T#AQN$S+f$QBDhe3(tIf=%(x|Ec$t{B_3`YHQ~+QS_1X;yLT)AjQ6qKTG!Sb zJd}tK2&O;3e}7lY-3HYJyL0ExPa7L#V;z8+uo$MU7=c(;Zg=S3+1VKlpoI+uzTyoY z5=z@ByKBGM$#0dUOJ$UKmZ-<1zlS18?dt?S@H4Fc05&jt?$- zM0)hB~!MTZaA)d?w3>9!J5R8bG!a#@XjcMF8Zn#LUv2i}}`&k~2&oelQ1 zyZw#&X$29`Sf(jy^+~Vic*uNPx8==M=B-h0`fOM9y4P2aKd-?hu!-=4*nWEe9$HbHO)VUL z@%?@A6p33Rhi;8YM z2|87cN;^Vhgj!^LEGyE1_g8^<43d8oMnvRkLB8QW=oH%UYRg4l*2%zMNkRW^eUyXd zYBkx77p7)qq!$u+OoI2i38P+|y{G)EZ;))(ZWh9Q#MD*(XFtY14*=Zud#PTqGsyc` zk#ls99x;lG8yvw#VWV0XJanE`)klXgc&UL%S)3Hws5l(VeCLaZ!4s4Lr~Iaef&T65 z5JszRe*b1~3Ag_JY);*~#N_mR6!{ij8izg%LN8t^rK(HI7vb)a9Hewh4N9LTnN!FD zbDM!52bIftEjQdrCp3-&)hWCBKLO0h6*@XQ??QlxO$B)7_Hvk)b2*>=^muu(RLE}i zl*B!~+Nb9Ii6&lY8h7vBefIo0!Ib--nQXqD4y_;k4_FmAojG|%cJ}URf=QGe7-bkR zq@0v{+&bVn{ehsaeE4c*9;PuY`}^bISB8U9>qpo*5pih^_E$;pKy zeFO$_TV@>YlolUvVXBv4b5F5 zwW<#AnyZsla`VEbjRR{m&u;yH?7ekV)!X(3PIsq>lyoDZGzXPV3F%N$Qt2)O73q== zNs;bGk?!u0ZjjEyZ=ZXwdhhl6?)(16_>J-Vj|bkvIiJ1v+H1`<=UmmdnZ%?n z%-UR+9g7_k_}syz4NJ85kv#REqGA^bYg{IdS{o!Y76kgxlmAp59HSLP`rx8}ulXTk zB*)7}!2w&yoB6y}Zx`}0H`AqOQ^nqd0Xjj?lV+)4%1AlRYF(SERmqbMJ#P}v`Kjs; z2KD+-=;1kZX=Y6V9M#%teMD5hnIf$(e^68yl@BM9Amn=F(jEmQs6K^Uik~_YquI z_&cK5qs=b&;-^CFE)GUy0S00*j}giUBvW_*Q(0?Qvx5ea1WM8 z8>J`2tjBSY>(r+>8nVr2eNe6umpCX1Q{G4mcX|~IChvVx@We8x~g)W%3 z5$FirFSDAy4r=U>l9CdH`sdp&AB)Wg4gE6{-LxILofbjL7V3+LB5iD(rbp^riy|p} zv28Zla^C<3jCo&iOi>RvNjRi>$mZg8c;eD=2!f{8a5W2N6~AX)s9pmw7FMmDd3W{OLC*Q_&$F5BfI(SJD)%}9rV!# z_cP~6@$#H4)Pfl!hk+SidUi{L!Z;!0t(4f9~CVuECl0j3|a>GLLQ9ngoeddbrvSs zP;pJJl)E3)yL_C+{7q%McOw!{g0Nc+#Vp zOCK=Q9VgknaU@q~WLuMdD5c;q7M>==Ff6qyU)d`Nq{?@TuM(w!RIk_8x$8||J=_?- zLxX8otSl&}&w~_DzXj~?w;3Ld5nMg;w<;ULOwcQ#eZkzGY8we`2YXU$kc^^3AYhv= zZawjiWK8sU|I8HcyhGo6%8?reh5J0Wo+xXhkJe{+$5|ykUS`SK6&_B1qp)scva+Mo zuV8M3c(*CqK+u%3H)eg}D-ixD_}bo{DF}M?D)i#)h;(H#J^L2w@@-eIr1J#%N13kMyjMBT{9n`Lp*MW776Q(j`cwJnV+yn}y!}6JOwv&FN97 zv|Pmk$~#q1(5p7=y?*m11i%$Yll57GunRtsz{SwV^pO8((jM{Q+9RvyDNs;D<7Row z%F046R$%Ow?=aJE-(9z&Z?J{`{!<@jJbZi_+ly@ldtbb;B33*S5>vJXF~*}Q_u!SI zPb5=evtS;_hlcEWOm~sYy{$_3_;`Co#!L>gso^or(QCK1IG1t1f6lL zZVb5_cD>xmZ=u@DD-#}u^989*8!!!iXhW6~gMt7CeD7~wdhFwO+_;lllx%x>bgL|& z*PAlR0ex{D3vOwG4nv%;LGICq{X?- z6t}kWcNYjR2|S%Xvc$%EpD!oLHKwH*VrwnT^I8t8IZXRTtPSPFd4m(Aqw9J5KmaAI zS&W56R^^Q~Du&AG!6s{L=x2kzO)RFrZ7Vctyb4HDLv=sl_xmXM1KM3FsSY3bi^cXE zMt5hR848>6BN7A39HF71y8r}} zJ&M>{C~Se!`{Pn^>^mH6x6WKbZ&fbL1z?K2IC>S^4+bI5?ByK_gkQmO^2Z~nuv zXNRB{xdyc7<#cu9Lz{&a9X{S8wQ$>)W{wPS*Dr5*5Q4nVuIEWuLv8!ij6!h1nFPPN z?n{%FL%>r^$)JcwV&~Mr3>S=iA!!9y<+-Bx%-Tpjd2F30;Hrvy4(M}wDP}6B#$Y>< ze2p)STRRWWY+qgj2{$NNY=YE$@ zH+qvIE!KcpqU-SXAg>R#np~Dh%hqzjax_b?HGB9IhlVy=$3Ycm25@wZk?3 z21&h_235T3{XE=sQ^$EpXGfdSZ%41lybO*;GAh&;>k(M){N(A=7&UGaOZM<2zrKA= zBA|=M?=Z&K(HPnem$KeEkZGVSyPtk+Q8on(&T5rvWkhu zh2uBwtxv-k@Wy(4(=9##azfPF(P3Zn#8an^%Qich!aYttMsVoK#v|2CX*)Zf7E#_G zmB624C!`O(AQI9y#?6f&PTJZbL~l846_KmsEN!~vCE&F2))jk7=@tivBslZbAg+h+ z>=Yy$#KHg3FHLs9jGxH~Ho|aM=(t#Aq$0bdz^B{^?2Z=zz0$a)(Ry&Oo4w!hI&9pb z{b`^5_BM!eAu+gE{9eL3H*F?as-4nxWSc(^MmTM1%ig{Fb<5pCfQ$vd0Kc`hmG^M; zT!Mr{mm`*YFneXX0rV$BrfaKZJUrr6HNJIolCPm-UFB5k*dnG+b2`KLb5;DCHib#Rm%BEy;We@4;=ABF0&JYeELVxR zOgou)APw16)@TvW8g9*WhERFEUAA8ZDpol)HNIl#&X;#ZW^va$%MSt|v#@+1O~u!n!4<-qgS!GOgko7zQ^)sg)C!T0JNX0ad}jE**NlVI@r z`aE9Hu|0FDI29DW+|J!>_A_ohZa)F0zn@viSB!|&2A{KS?|xflp8y>mRN?(zy}Uc3 z_)JfH!TgFVwg(Ck*yLpu%l#>LSXU=2YfG%g)BtU7BX5MWva+(sX_G;#=2!#FCJd}* z7pN@MweK>geVJTU9mEM}h^H_F=b|S>2$D>P1l``oZ3p)rL2tUFoG;)n(w8}X01;8n z&FzKNOkLM#`-%%>*)mhdwpIePWfOhQ27X}_`&u%&69r{u7#`4_W3z{=k6gJO%&9sy z5qRGLJwr#Q*VQY@@CZamvf7ZR2>PA}h(?%iup$Xyt}Yk z^l0E_vG>L4S8k^bbtF`zG$}?TS$|L)rq2u9kVCqy0Lnr+j>>&It$HudP$lb?5Srb& zfSv%9D?gXczh#uk#>k&!4|gS;9eXwr$IERWkr5?pY!BzYb0+|^I~=^1F%eiE&wWOB z-T7$Nl>|%$GDekoRee~QlFfQJ>_AS1e2pkMd=L&nM5<>f)oAtYw~fX$gK)ZZ>Aqb@ z`|8yz35>pKXHHk>$ub%SlZpw-9}wC1%jUPYLjBnHwXZYwRN_S0Cig&YlCW#Ph)j=! zR~K5rlllA3am%EcUZAB&q|i8B@W8W272z~*byDnj7PF-e6cnLX`BDQVChx9}m%dxk z`4Z7f!0)L|$GTo1kZsgb6kuXE*>R>VPMy`bK79VaqIjfp!0^~20ra6shhCk zAGxM)KW9h?9%pzRRCcRwSwBX=-c;F^iH%J@@7kV}>#XltI?#lRQ^ftk^fq}1Asujz z2hssKWai#%v_ZEO@$6`udCB@MLx>VjV0HZ-=6GU40`1sXOju|rv)E-k%bgedH_C;X zR`~Zhg%D1wf#7eile`~-Kk}(=iXtO(8y{OgOQ$?YkJSFnRQ1u@35=Cdy{eMv<755_ zDDNLJ4l+iXrJj>QKqYa8IBSwMN~0ha&eJgLwB~IoSgZ%t{V8lLUFeEY#*e;weI+%N%j>YTa40Y^~eZ z`%|5Q6zlbuo*n0TBVd3gewpW^KU8wQyEMs{wXR=~N#BaG-p`A`oxbeFB5G}GL%)&? zuFwtB91+9a6Np^~X+U7lz| zu`?I29oynO`6L%aq}HjWlcww$(8>sG8Z2L2=`%_lVX-oV+`dimXsjq^*<{aidqzxR z+Uv}ItjNS4$jXW}YMG?Q61G& zdGbW1<#=^6y?B44?=o(M6KDQ*fLni=hEPq zYZ$mGpy=Qbq3bv#u{1Hms2CsOx-t3q)_IVw@Y%8LEb zbWPz0?Na^2Z838zo)G#{i=my$rmnd104TuQK{nt|$MU|4j_$L}NFD_pLq>*@x5jfD zjgUC^PaARZlcOILqScXM+_WBN00Rbimh4+MRLgB@=;((CMZ^TF zsw~YXdVtSE$6Ql=>K{C2iN+>#{9^9%wK(~IV+#B$>{40~O^SHZzN2s}aU z8GxuZVSKbDKd(@F#oisYc6(>%@q|FdRYh|5TWkh(+BdC6Spa1%1oT9tfvUW-e3y`r z5aDVg-~D@@Hd9rNA|kK?`T-3-kj0gs722*${0nF`D^tD1H+k>Z9Yid1Wsfwtxy94gW4%L&dwyynVE)1J;X zC&Lv^!?{<45fMv(2fC-JjrFX+Xq97JS7U1{TIE)i+#ARXhQzLuI!lPJ{`}`x;U{Yc zhR|~fQ-&8n5YUWfm9;eBb-Z&ghU<$^G4wSnN63c{w7Y9LRI>W|i9p2Z7}vQStM_Fs zhm#wDa)Y#$5AJrkMQi8evZz6QT1Mj7>)QhxGj<(UUcJnU&9AM%<>onxiyo9G2JLj5 zmEF}<_f9XxqwTBGU=KP5V2zaOTL07|`JQ=y4_Ywe&S#06eeYVPiu-Pj>n#putL~of z*^=9~Z{H{xGh^d+InG)}08;XhPK1Y(zY0=Kxs6Qg-ax{G zcc;beYm>9d#%K;3BJsu&$;K(zxG{IMk>xb?0MnJs~05ymE2rkxinQ*#y-XE$PhjWFd_O9@l zMmVeu4o?jinebHZeDd8rU8jl}Ls{z5Ss=WUylgq^i-No|8mmPuDA+FY!mICMbH;Vq zelJnq>%^1n))vEr8q`hcV6CYG^s%i_NI`_jMdroyLAh)G`18h?7$`7B^t!fsWWqBp zNr;qXZ0awrJ{sL|js|n9;>IwWgD;1%xIhP>?#)%cQBRvJZvl^Ed1~Ko)p|y{XQyvs zsQx(~{mA?yp7|UwY}4NexAW>s^44d`E7{o`FAZT)?@kLFv4WrR7Hb)NG>}oLq1-^m z>v`t6&nIUeoPxhOckdj2Vifd zxuQ?WrewXgv>GXWy(akP_uA+uXyr%fNrAZ_ql;nc)g*G81ihiUOb{T{n;f}yqGxgm zeF|EEMwClEM6+v8mQ;^|M!^z(x`0m70R}Ff%?|nMa!Bz2W^~dt=t2%mXCb^YLgo1aHJ83Ii1%{Mpn=1 z($cKWxm0~RoabqJ20s-BAzeM#^x95!1f#xo^PH&4Eh5>j8Yc&|UY^Zl_NU9CKANhE zDP)J-p`{h)D^4l{V}KhxgVqB$-h;U`{lag8^Ecm@or4GPItHZM>jfJ#-mOK!_fN^C z5U&lcfaxA(M<3?1zJ7eF)m(}b8$-M{_{!0YytmT)UNNXqDz*ncur-TaeauePu+H#buPdY|ye3{){uhS_K%#myZ zS*@*MJ9Pq0?frtz_L@eqX-Oq=gA|qLBV(3U;;A`^cgYI* zDX2Dh%Mi?2s&ajgjuR&^)bhO;*y}8HbCfpU`NAhIyB-C+%v#fn+#YquIk_76)bk9d z6<4e?`Z;EF3`5=_D1XU5V!vv>iTG4cogSL4MdF|j%Q~6@ys_O3eS)$jKu(eR<5d3h zcaRgj0s|Tjsv`q7XF!-F1hYJXdP?^d9Q9t>PV%?i)T>*TSs$@I6lNPd(k@NCNE`uW zUf=#H7)Bc%$vV;zMDb`TwJIZJBq_;D`+8_7{!*%2xedidkcJ9H{{YXT*yTx5CGk^J zS@S8uF&CV#Ad@%YF$BZF9d|o|oJb9_nz3z_he@ zoh(*Y8&s}`cQ1WN3qiw)J>N`YdrAwD1O-QU=Dcqco|hjMSc*XH(-*NH8#y~4Tp#vc zomI{sC%0>$@srm~6*cE}#8HT7OQvGNDj~^z-hja>;@hyk#;`BA^0mR_k!V|-cT&sk zAkBzG#*A9X;cR;fpoAD-ctQWR@XQV{`_fD(;n_36-3CN&?umnH)xJVqiG1-Nc-TLG z8sA-5WO*sJo|R>>MYcAv75k~aBEUwZH%%t&ga=mWNY6eeoerIxB;+>h=GsTGgY#M6W6V9o7o;^|RTyJc;#iKL?hq|2%XPpJuDY|Z}X!Bl9aYt%z z*OAWRL7~HQW!|4^sVzfc!ub5yb}>xu#e{yd0mLUU%VaW)i zR8(9!;&a-bo(C0*$yAlX(!^3nRBo9CPL|Ew=k3MZa?$XUJ<_qm5eX*^pHFq3sFN4( z)%tSrE#9_(;?!@dff*UwNc`(){wWFBYBl~*Z6qu+SwWH zjh|j~cu-#;(c>s0N1@u1@z2}-M+AqQ5WuRip`4^KBR$fXqm2_!8h*`S{dMqX94avrq0ewO0Zln4uTi=dg=vo%4cw?L|N*gRn5BcPU)vdby1X- zV(g_B3Ft^%xNpP+oo&p#rYh~r(=zhx)XzNJGRn3AMxt~!cHad>&Dhv@94GUr!tKCq z;xNpjVkx#yr5+mNgQ7P&f`tw89W)ogagClQ$jB?2f(*$2nwca)vZrN}jaqJ|+O|-M zxXA-16a7Ty5vak&%Uo~r9}HMVs+}}ap#aF!<2vB|M%|h@*UYQg#Z`GHSt3B8Hwtu( znJ4#ML3XN^t1Y3T(#^iF26~+~Y%BS^h}VJeoON}Cvk6PS_tttTU~kui53R0cG!Nbz7?T_cQ931x_ z8d<(F<$WvYm{(#k)XDf9T4>bL1;KE{E+rsV*8@a1S&#;#0$FX-B*rYPejP1KiNyEl z)7LJuvaoqRE3ggPv|80p;cWWnIiQSao=S^B;AMier2YG%6T%ifL9i6xlLw5(I*~YC za46KtS62aJAsOt}bB*52`UD3`9I@}NyyJWuunN-Q7(ml%$b~@>c6(jkyriEog*5aW zh9OTunHP)MS=D-tSX}`?nTDn&kJDFhF)?`t`hn<(W+wgm_4l!u;~>4QJF#MrKUSUpEdsdT#VWe@Kqt+XPYCff1rhCyDNV6mVNb#3FAw}eJEYC$z&Wg9Sy$A z#hyO5Fj{`3DF66f1P`p5OzyE*Xoc^u^JLx2T>~n|C3laim${BrS2ol(PSrnX_D!zW zK4?5u%p{f5DK-sUQ1Y(Qt~<4OAETmAT6Q26z~Nvy`>8j@6Ifx57AN+s^xa8+H1J~S zVTt}7(gckUnwCL2fb>fH6ygVROX*l%nWCEe#>USkohD)`*PIY4D;eoTE{+_arwran zqRTS*`crH@xc5y!7Fc<<6(>>7-uwKLUhe)|F~Pd-d&~J`n1J~}9Oetp;SUfcP~vZz zbjKSQfBCd%2k^6E8ASLGe(=1IG|Lg3{%Yr2No?qOH~xX!_^smpJ^2BFR{2ZGz4o5X zs6e5i@+}^oqZr#yBOkOHu~2$%9R#Ern@~huoZ()bxN_~r%&C&}OTsP^JafQ`;(LmK zL($I7b9L}Nu{Fp2>M{m2hxp>n%n1b$ZEuy|?sd=76KclF;-7dDaCTl(qgrIzB}tpp zh_mMfvIbK{8gA}>57F2$@p1(;T-K@D}DX50mzn-j;h8Tj9EWBi8% zJVF9S{hm`@O#JNzY_9>yiwP9p{^>ui`fuk1Nx^62^;5|<$gls&kMr~_5xii^k^Ecy z|L`Wh|8sFdP;8n*X2GHu*I-f03duJpz%lLCrFM07HRZb95v5@5 zuLl|!;G&LR8=_5jKeA^(%hjuvVNg7WmX{4I)vybxy!z?6{d6t)_&kMVgP!w~xwM*t zVY4Dn_gFPh#^{>Evi{G_!x2Ce9f!FSD`EKMlL@!uny!r81nr2P^Q&k6{z3&rd5_v7 z1OP}xTkGaXnAzYX5#SXGs%#n1#VPZJzj1?)9(2Wc?ID}vH=f7gnf(_RWrVx03e^=Z z=PgcCWgk=ciozz^3XJYb-q( zAs3VsdI`xsA)bQr|2|z2aNyH_6Q#M!uLAkkF|loLaw0HcQ8?TZnH_b$IAt#~l8Rj! z6%eRYf#EEC5Ww2#+=nJIQh~l1n89j%KS40k%nLO2LIFgvwv{1{PR#luz~)i%VuSCU zrDXtw?;Xe~+AK`pq!tpA(uK#0-K4%*7UdcQ4FxP+tH6RuVVl0xSAd`d+Oxdd3foHM z8okyS0KjH`@}zKU??c_nePqBc=x7d{FrFw&fc3umTmen0VKVjsfD^((3pL)W2XHl8 zn(#dvtFszo87tpT4*f!{vo;bOotAdm54ZzBAriJIp!Uy1iofhTqF~q#%hDH70qp=X z%n6-EAh=1@!5EGF_|(1aWZC(v)}-@+n8)!;59mqx?s~qZuKJeJR1pLb)24dU0`wBr z@@7g|?}%PFgq>;Dn;ZHR@gu-7D);sHUUz}VV6`KrZiT4+qkvaoD%!dz+yPq((W4#g&R5QCnVJ(u2 zLrden)J4GZB`_)!`^d-zd5R$lJ+_1~0tTk}UUcLG69T&d1&xKc>KxpppO4dDJ~`}4 zYob+NLqy!q-DlTvY6Zfo#o``@j+gis>23!WQEpYExnlPvW;gh)tS9eF>Klc5 zUo*TV_5x10}{D4Krwa>BQNO|k96N@GJ z_+X%XkB;ABNDuI>z}Xk2l1n~>++OG9shInD z)qJRCfEaCxf|GR*pk;yb zh=G9(FSKD~iGkZZ_`+u!adtDFMiL1>v&Oz9d_SI56DRDEoF2&Cn9&^BKaZ_5AYGm) zdBjmAJq-i&)H^Oo5ZguVmk@ZEl4T>??RrGY->#nM1;4xZ?(Ql8#)J-7@Nw98*1Ib-anIA%@M-3wA|ZPIs|^c-{KMX)OM1YQPI= z7nh1NwJC(z^yq1xa*E@%oJZU?lL}imFH#+^LSXzzQ}JFnOpVp)3tc03A9)^Sz}lSQ zp{f`^P%Y-ED3h!JJ&yhyja$yeruTc7Q(?vi$z<4W`zsqZfD7^CgZ|<>$XE1d#53uy zmt+cJ>zmWdxLy1 zA^gOYs>d3k^ECksk{D)Wf@BT=M9pEf|6}}EcS3a+9DL8CwP8%{DrYe%;im|lvh%?J z9D_CgV303>Hx`b+S{2vn*SaJ*VXFWvx>PM&rKuA#JK&4)@3)rkLwu$KGDJ0ImiMuf zj~h)=1BR;Vf!S|dSJMjURgr7K9ma_5Epu`YjNwvE_ei_XFjM7mJYKKVb`YP+Ghc!O zwhy%^)Bvq%%CjsSDz_TrHOPSL!Cd$7hPq~x;f2Oj&Ww^!cUuixA;Y3qy}Rv=S=T!4 z6(`g@IJlmhd?TAg4%G2hs|{O(MMn8QkeIRm^N5tU#`{yMKcCj5x_VteGm&KDkWggn8KOjh;! zpj_tN1d<`WWugN!(88XO%ks}LHcN7?HVEe7KCF6AQLf#Kg;m84G@mY{*5q8t{=j3= z3PvOXN};hGX>Nrju9g&1-*`d;WY((1;QsF&J1o#_yF={3^3@F(&}GI>d4P zX4^CLnV2!e423vG3Zb%4;Ii~K)7WgeO3CwN@n~u$p>8E^H%0kVBW4}>GyIWRjt38j zCuef&)IMCXQMVq(ChM1i5!hzDgzfgsS|Hpky zR1b;4#@flS>PyYmb?8%e-7LlJ8axG#1kR`^E{C}qoYT64haZYh^Oz6iEVI>Ck6IGr z-21=Yw6pWVjV)Nq3b;HiHtE0ttmn9s?3rLn5eC-#ANah%^a>8pQZExs5d1H;<8_i_ z&*v2{In{_7wYp8PriyOjJXmLZX@d+);>G~T%xgP6dU$hSfX8}5nEdK38|u?}79pp!wuLsHPI>HN z(+fJ_3Etf~J8QB0g9ZD`7F4ne5=Nqboy!t&ue!zX8`I86G9&mY3W`W|GR{&KKGszbdpX z?cR|M_&gv)GGU7t;luSlF^S0;U*4OrHEX|vE5g_#auh`tGCM_ceNKJ}zRP%4O_vM< zNYfS)gH0TmlQ>M|Qi$PR4#_<~*3?+?yO`|;PA z7;A78q9g;ol-%%M z)O!U0pgRmmmSt^h@+_|$W#%N=JmRt*7w&@~Y-Wxy=k?cn;{vDm0M|-b=N29phKj-{ z1OR94iNk~z7M9WpjJd`6HV1~^MdT?e2BS@s7|)DJdN;6UJa2W>aAMb(_tRxp*aWWs z7l+CPExv7U>)yTbIzVSphMq64FK(8Lg~Jg1)%2sgq$Trn59zL7zs+k%Eh3`&TkCEK z_nJ!`7WweV^391-OXd+>`@%|UC`fhg7GnZl$OsmRCP17kTk{zm*9Ij~umxw9J#tq7 zZD}}vhVAOhovrHmF43x?kKUJO%5_i>0$y@7TN?W4%Xybf0=-u1k*e23#ScG2T6+&t^I-$}m8 zI0C7)fx|}+TRS2HCmPu*V;)9& zGhwz9WzTbqObI|IC=Af9!mXyNfT~Dubt@-e@hV+?(KQZS0L)kIl`JeZPW zKD%ai1gyf{Uj^man2PkuV}o!2dZ{ojFN{0_>q2F#=e(H08~kqqdLaav*3f;LJ+_QV_(iCgX7)vjcN`gWIwB5 z$x#m=x=8ttf8qBV<5?6W1`7*~eXch?kYi3ML2x8Ko&$_|i_v>0k|ecg$?& ztfyk;?5z&M z$}pUESlC({r~qt`utVODV>gk4+k_ekkOHWYfP2+H_bg%YCpiM}$dzR&)$S?SgSH>H z?ez6NEO=0MFPQ)cfDJ$Zd}T)FOo*t5VX~3ZZ1>clzmY76?gP_`Pwh`Af1Up=D#3g$ zjyl=5k3j`wx6=Edt*a{%6tHw`Y@J0^zv~`TXh7H0To~2V_oq_g+cgY%gg2|c)4vn( z`auvei&{u5-xx>om8?pnU;pVp{!`@-2sI@7A0~DGy^IBh@^i%0Mv$*=_I!W3hhHmD zb8;#H>v9%AV1hYV5s;DHvl_u!xGg9))!zOdBzEe&ImEwM#%_J^1d4AN|9OngZAHV? zezlYJifR+kxm%iaNV(XmZfV0FF(Bo(PvH8BSqTP)ur2erAIbxfpz)X_{Xc(9B6;xI zey)ArXHqi}_yTvU_A@FEO**4;neK=l5Hbc`BMIsy6ntmm!JHy*GGHDGte!tAUixCelO0c;$)q7i;^9mgZoyUWiNnqNLxcYeq(I03hcFpSOxNbe5CD*b*xA_`gGbyEV4@%LNXsB1 z5<4u+%3n#=!f-+o@t+@Ngo1BDk*m%m@t=OZs4@EqQ&KkYDjyqsUe%gxha1b^o#K8! zRmmGLi#(?!cIOv=>|v9;F#o#uAfZ`F0+BNkAKivl*%ugpwZ_@jFaYxRmMZLQ!6a#K zfC-uN&jt^Fys`(70z*z*x+lMFf{2H{{*F3#`_@ zcT(vE4t(3u9(b>tQof({?E;@9V&wfVTP# z@)zKH1r{NcK7jNzep##V@t5l-M?5|4K;yIsFpETmt?eowk7?Jb1#q{A1A{hcV8SqI zjeMdKKeC%R0%VSD@s;*nYhY%S>#geG%ahUh-33*p>fi&=;!Ieqb)IR{Anh~*dJxLh zfpYJ*jL$$~i zOO$xZRwKui^lEpatIM5ZdT&QKk?TRKFf^ZW0eDj+4n@rj1Y#lB)_l!?1q7JTCZg{h zXVHe#x4ruPUH-m0pn%f+Y7oZyV{<(#Y5*2+i-$s6Y|6?Ii#2XCUY9J7<31^`rwBFM zoeo5FpUCrUZ!h6c2+{$KY^FJeMRGVL$eQ342IG&)#Nh!3-=94our!PdGe=FAQ?)LZ z6F#23!~M7c(r5n*h)UTG76#%)G`{Q15C~xR#0rAd16e==Ob6m4_@p&XrexqFc+xyx z<5~=}*Em_zMg7f7a5aNm&wt6RF^z6@ralRal3UZJ;tNAtcX#)Qs5jI@tH>cc-o0A@ zFs_sN^B3)(1iYTGISU5~B)zGeq~r@>VDU;)dzYhnLuGX$Q>m`(?OW}WpadL@Q~CI2 zjI_=9V6o5-AJ~%efI2j6`SL6tChY=@m8s2BU8vv|C4d*%88G`AvJ*=t@p=2 zu9ZLMJ3z+);ucbGCEd5BP{#8m)pxnKpUJg2pd=av80;iVYJ2g(v;ua3(`DwH!v?uz zQr~Oz+!_wx1l~7g6&xGxr~oQ|+h1Ef>C$*$iUQZ;b^%?CHqb&rAzCi2SvGd`=oUzr z98&Zp&($dn15;5d&k{FDy}?p7_kcJDB-lVesayAemwEv>EYiSytTggbfqhr#h`y)9 z3oHtTD*9*6eakY2KIOllgAl=d_L|nahQ4oN6&mHjhZ2>GOK}T9LN?JX>hDLpwFV}2 zB6Vyk$KDGXOm#IMSK(d&cG=#L_tDhR?x+}5mqsQkIPXaT{t$^|*iL#M1IM6rTGem| z=nnuP1rg?|Ai8V=oYgXeeu0rO>H8MU)n3#1p`2mDMhF%@4*>%~_*;_UJgXgvf_z@GLA z$F=LIzM|o&i8g==xab7$rkB}C0HAc@gTX6*_nY{mD8B~IZv(tP!?$EGSr|jtd8#xu z;0)T{92mz|4RY=~{@CSKdwG+kmeJ0Ut~Jiv`d>W|Yx(m{1X2j{u=Zn+>|O}(bG$wA85Yv?OC5tuJE8Y zdnm>8(R0agmi?KKeO$YM&-WP!g$jJQiG2hqXF9kFn8Vx)* z%Cp`^LzZu^0g=H3iGw%@7l^Tvk?oP}XR9X^f+givm?hjSEGz~ib2aztF#Q|E#S`1c zl-(2^a~4Uy}+VmGw?hp1;L-PV{b3v^ACT6zbr|_OPIbCO^8(D+ar;!hZLK( zMFm`f0|CTz_=DtZ-ImCXbLr*<>Z}^t-8a+SodFGhJLsLH9up$U{!!l2m4AStz{}mf z>+=SlW|#WycYTxcI1=z%P6Ibqk^Qn_Qg*(6u_OTjfyY`cYZS08Jv-b!%8L@Mb(hl| z-M;Yw7Gm1sO`1aAN%h!0n-lN^Q^%r6!L5>RQtNC|U1n`EUP4v#PsUrYBj<|;g7#la zSJ@n&j4jEZ3rWwrC1(io8CUQg@+>k6PF5Ww^9C{zQSlQ&7>p_SyOMUa^aM=jR zE*6xGY)h?iBVSzQv(#2JSueAWI+%`h@Swf(HY#032-uGh|wg1W14}Bmf%efRHfg2Jn#wpwxZ@kV`TFJLmp- zfa>u#*CzN9vqm@zpU*YP0n`vX=uCdL#?`w6masBJ(?Jk^_4VovoCpeC5$314A8#9? za=jN!IrwOMx=+^kTEt}sPpiry8~754%Mx+YjM*DU)A|Ruf?1s=8x=E)=O=r8{R=%w z234X^&63ARbPI*oF!Amf_Vp?YEON0UyrBi7(^9<|0&qoL3@AMp9u&tgMG*^ML1}o0 z_=X>ho~AjPaZXB8h#O|v22I}upfrv!kPHf2AIaDGqDuo$K>dp^Xe$^)f- zG(SckTYv1Y{PYOjbHLL9R!?Y^+tdOog47L+R-gdt=f4*f_RIIM1wr7&szBrvREqiW zZx9rcfwTvx%B{fvl+I|aXQO2(gtDl!oJHKE30_q7wF*V?6j4^LOJe~;p~JW9$QdMF z6MbDL!t+0zXHW@_7M|-V!Ty{rgJ!8Y@tHL(jP#S`EqgcFn*X*my$= zI9ruGU9FRiVkP6&Sz9_LrdFLn^D}~7%|4thdTN8Z8tys&FWmBhHQT)@wN72z+m)_u zqT){K`S%r;x)RuvJkCP_tir6uq&e+=L=hum`2q=*be|;h>{rVHer`kSOJt$gODDp- zk}APEbe_>Ns9Qp|m{%Qp^33kjvsF7#w=!#&6xbbUw`KCax%$mL|JDDr@7NV|#(Snt0@917OO5Ubq#c7ha zlffPVRMb}BLA*Gdawkkcl>vB*2dk-~AkoVbDcLQ5MhO2YPW*BH8WN{1H&-7{HQC%WFI}`47hhc8q*K zEBL6Q(`~Ic_J{uJ4gCCbNIY6E7q#N?+qXY9)PH#7zyFHh7W`F|{}+ELEl73EIR1FF zkPu8lFcom!EzzxV(83_;WPOfF8Zp;&ht7JO_eSDLDD4-}mp2u7G8d619eVrrZ9jV6 zk`N-M5Dk@#eVgDXUp`5Um9okMX#*oEr~YsY+r8^|!D@1hmS0U%%IW=s?g8sg0 z^P8Boh;8zP`b%i>q0MN4dj4`xl2oEsRlxmz9U*I0Af@VE1!LWeBKBKxRjM3rxUOZR zid-e_j4QvJAs<6dzxiH$-Emyd@x5%^O$FnP(KfegopRK7WGJ)8phHJ%zr;ooAD|b- zaiPJWl*r0iJE%_1GZA2*6Qe(9J)Kku09-MuBCiV)8Gvu8<>}rJJ_LhwYp-6^8vx(h^gS{` zhcw~Kb6Sf9uPUZhfI=(?2(oG9T~n!blknWw*$HQv;sBG519j^>_++mh1wNV2Xa|-X zr5b(=3Tv`$VJYJ}aJ!l%=II+_#Rk9~l3v73ID5DIOJe-QzdZauU2$!1;II*`NQo#B z?tjqCyaO0PG}z?BMTaCTYLM8QxjBIdhSv%n4LAW&RaGe!Yqhigqjzv0oLB9FK?p|A z(Pq)$$gD+%oj^clO3q*&eUFXX2@PkY1r^e&Td~K9N`L9PXBb0QZpT2Lo@y;syQh+$ zhen=5WWD7`w+iTIvRXWT>}8$B_3$&lo)g=HNyxvP%kOa$oO&(YQ7gH%SPdLxEGQHTY~2FN#H50(0K?~2?&ETDYyTb86vObvH80HNd%Vpuj6jY*o<>pFYI=^Y#)u505gyxsB64FPYc z-&hmqL*{bjBIm$=e8fRKAK8~Lwdc_rdx#78x=8zMudfV zx}BSNlwK;^em5EcN|TVfT9BOFInMLR7g5Um%4{fs^N-}|&(G=S?;*R?kVd%jbs$$a zO8?ABH;~a44sHryQYUnP+c&F_?6CR}m|*cS>y$myk&SkT8hBsG;ZO=c+-zj>X4<4F zwbY30h|bqMi@&duA^(NQ>Up~2rqx>?qlN)^2subzWG=6llReqZ*J;HPofAX zc+F5i4blQnMKSRWp3&V9_BhsDRpDpPUy$^R6<;>^HgcP^3y;-#mUkxA%L6+DYT(h) zTdk2lofU{MtDfwB)PmIRO4}6RkLKmLrWVOre{E}p4{m^HW3*5zh)T>POn?JWH@2<> zJ;HlzI8C0!2b_ee**L;~`9zXr>uLUi9 z>D?FbAiPJuA>&yI;C}GQVUw?6fY?vNmsxdbZ3@`HM2FG8V_6NR5aM_zr39>bE(&h0pIsJU){gE22MGdV#I8*iXM~2kUhMrZK1IsYiMs;>K#F;{W9yrgLrd z;eDhc2RNVmkphluC4hA4?DqMxEACcq&hrEB%c-oXV}pvv_f$aq0n^c<^|eC>WzEeW z!0t7t128OwNL;tt5W{bEU^yrBP@|M!=FP5D{KF<)TId5^AEQdlb}pl44{@>tq!-9< z{iszl-uSKJpx|6f>0ZQ35K*wlL>$q6Y_m<$n z@wxZ$?Tv7U$uRl=*+k(=;iV>u|3id(3c=ueeNn&gn8kjXBkB>DeIa?;IOUzED=>J7 zE%4;}Ck$sYf|5v(J_sfr0`8abV3yc{=oLJ$m!d;L3f#al>wfVAwnd4sL2Q} z3zrCC$v0ORujJw~D^ur3u27l^b7krg#Ps>lavT;&0KKD zhnqsw#b%rY6&>a7SPi0AkRn($WVOp}=zsyLc!<ZR7y}2~GXhnAvpK@Q2 zVn~kpV_(6B#RTBukXnoL77a`eBz6JTo|U2~%H!Vqed`ReCG<6fhJx@ejF9n? zM+0m8XyjZC#Sh@Fe}wyZh1BpAi58Sqp(xlE7Kn&E7k*h{_BuNpESo>P3?b) z#uW)jVUZ7f;9oJraebnCx1^dOPoq_A+Sd#RFkGH{9@^KFfbOpYTt4*9Tk&hrwB!4T zie!5AUV2KXJ|*BT4F#tz#}3JK_ywTObts7ij`({nMrID~qdt#+ZTS4b8bSd?KpD#W zs9*D};`VPxDZ~LCr1h)%LQ(Pm5*-L)A#2Y>4R2rL1pC~=*gKS;3gcvUIp6T=(;8R% z^`!hqU(gLtcKOD4lAp{AhA}EBwxj`1k-;xJxADT45$|?}(#AmrOq(J9@)UkVeqUoH zYAsMdH09h+hEM_py#JwHf!D=-Kp9nZ!+^g+2AQojTpM%+n(&*oQy;WEzm6dKDYlCJ z_kTd>HKZtBmO5Mi;~oE?cHmFTfRAss&kREgTq#=VNAhQSRS736p4?HAdAwbln=bw| zR_1_L%jUPg;0uR0tA+sY)5`X@82|VGJBvdDcEDYylrLn4U+0F39yV!PV;R1V<}q_( z1}6seNA+Hl;@(+smuFFZBfLJFsQuTA0jo^uBmsyZv*A}*@$0|(^IyURMdtCHfG7X` zEi6s_3Lo}ZstwsV{^c3}IjK9o1Ku9A_o43p;X_G3gaK5aIj#iA{q)ZNRIdE(^FqO@ z`G}QViT;;E`RA<`b_G^!7h*Qg{cFJd@u7Ugz}uU}WpAecYlijX6#o44|1HzEh5O$! z{T^igcba~WsQ)`nzsHUL{|7ylGs2jkE(~e`{LzXh#n*%#G?P?vV~6Oaf;QS#_ifH9 zJKqXOMbp?X$@eFFO-<-idSk$x#?NrCg#p~K4HOjgASvoE5Et<-GMt>aJKLY$Q8b$* zak}D?@zqLoF1i7j880S1m)jTLU1(z;dVfD?29ewO`!$k;Mz?rap~ToKE#n7QpBwhs z;qjN-UXG~-wQlNQD^^ z#EIGxb=ns=7I-4)ALuMjM#>3#z3bf#qfyXK8sG*w3Smsk5PqaLH>JkNussJoi1jRQeRKbg@F)0C?(Q67fFZu+Is4n^ z4{!~$X1&kz-uc}Ds0n}Aoq1_q1VR9BmN;Pa>E)UMjA&?_gYvK5K%UzAuKodCz7@8r zRs*>xLtujZ+|+Vn*-@fVXVUE(Q`=t7^m-ZpoDb-ssJxI3e7LJ6P$L=r2lMj{@OTTw z;b+(8hPE4z+=DX)q$p{)p_I<_7wh;^b~Z(}AsngXZ?fY7|3@eQ)M7NBExG&d7V?c& znyBxm_SY@*%<)424**}YcN{kYca?a87SSD50T7kHU{L2hs_&368Tn*Ka!mQ@MVzBz z==JFu#N_uyS75m%ALZ{zNJrwXX}23GEktn*+}6 zlZPg+hiXz~ulE479SvYwtK&1fRnnA0SW@H8Hh-E>SQt>F{phd^tbeWq0g{Qt5KL0v ziFNOW5<($1R2rRs&$m7?fj*)4->n4IpcCN#MgkB=ZUHhVSNdM=tJ8m8nMOxcp+^e> ze`e#s%y$5e@O3oo4+ZFng@eXV=w8fxC{r|3|A69uRy(m(l%Id6PR$-+8nbLy3i1t| z_-M}&Hl4TP$=LxcFnhX575VQl|KScsJpX_9qTUpk)^nqjBJkeGu;YXf(TP`5G=fxT zGVpSyHF3lt*zoz&h{kt5-s%8KUcF^Jqk+h>CkGRL+jX3OWW;g!1W-jh*Rrk4>f@s%Vb2(#WOa$Y0+!qS z#iS_|okP`3^8fZ^A8e^)uKZRo_zk%G_v_3Nl8^8gpNAts=@=@BIIsD#jiLf9?Yy4N zFrsqI^xf@zSs-3(qxx~9&f)ZHqb_hXauDZy`?Wo-K=gihB5{E+8Dj;=dn(m_uF$X0 zC<}{Y(&{!@1&kg;)qBjhFMwQEs;Syks6WDTpxxVu%YE31-)=LDRMcK2EI3#y2yO4C z;_K9;1CE?SyJM-6SRKke9)AR2WIlZzG-(Hu3A#wT-P=pY($%%&1M2O#0(oMY{&1o*iLmOI zgUr}HaQq09JaJQn;{XG6m5)w7gN}er7i(2ENxz$|5qbZ)O$>Rdf^oRkeMG}MN~oZq zmcw)jm|j0tYqbV!b61PZClcfvQZ>u;sT=q28-4GykxxS=Pm)Bv&RY?yJt6vJ?Ate% zL$QL14kY?&=k0IS%h0~an!ue7{Ftk5+8s^)yzwTMPB9V4!bAm&d#t`WTdsFV6WIX} z6E5dvx%54c+fqWUCWpGLAE3?lR;Ryz%w~2Rppog|3XfpQI;*+39Es02&4nH6CG&&h zdM!8S39Knvsz2SrF35eZ_vHZwD1Y?T97q#zPy@zEAwMn?E(;Jf|NH8JYXY_a-*UP! zTernU9>1vd<-xqFlR-fJSWQJ&?{^s9i0lZye4B{sxoJ;*o6Sd$oB0oBss-cGr2N%d z(xbvAh>c~NLVULCOegc!ShJRmw!aA^o0twAnj~CT!$;cold{p$It;T(l~;iq{x=D& z8k@F#Gq~f05^8{6oKC&-oKNE}pbVWj=#7Jy6AS|K<162obe07MOrE^e zYoTc9*)_N8`qNn^N*l^(OUt5Zw{eTao&&NOAgw?6Vb@$7q~kO&@jA` z8*cl z&CU18rRzK`E*CMOp)1oUf+onX1i6-KQ5nX2yklwtvd0 zTPH=N)-%{v)6-fdumtcD6kv&y9hIbsc!OS2KB$Y<{448NZF1Dv;BYg~S3kQ?LRhey z+BR)w4dC6}14g)Do6MdJ9K3^^1G9dtn}HN9??3icnX=a{6;r`lULn zhElbS^62BaVga8PV~UUE$_H@3?iRCf;XyXkLvh~JSU+F_%}C~k*gls<+FG}g2>trI zGm|fSFt;*$u|r>cF=KVS!kjpfm}w)OPnM7@(jz2=(4j z9!|%{fBRu6!|NEaY*1p8&%hV>s^=>2Qt=p8JlY=;6!XuI-sPg*!aTBF*$_`# zk5kfet(Gb_ja<;}UX7wibOjOyc3Mc4!s}%qB**D7SJnKml42Kf<$FA?2IWt7c0$K^ zb&1v(P2uoOq?U}B8u(QBD|S~SoxlL|Nsd`F?XKbbj54DEm6Q2qE5B-b&R3%|L6M^P zl*R&C{IRO;s({GK0|PgSkgXJP%lmUrib1q|4n8jLV~PYSD3rnn|B13Ak~o|H?tDeD zyBp(>g8@YUBqCFhD!S@QaR-&l`sjc|*wlKn?Fb(1nR<(cwc#^LA&DN#T^xH`$G1K; zW7T*Na>VCRd~K)sl+|5j1#&qMf86BmC=dtE*Xz}5;TvzHe8gi$1~_G225d?)!BtkhM|g8Asi0o8C9HJ`E00hPP%$NxEs@3*hnk&ee8>u329FQX!m zJs^uTZ*48zS+GQ3&snqxI?DEMop$x~Eqc7hUkuDG?TN122x${u&ul13$IXwnA#rrA zNQC`Oe>8b#YBgNLqutVX*}CKncCF^yPKvx#Eli}f-TyH~^|?#Lcucn`3tcjuhQS-j zy>QA~h0`E(#)kRFS&T4v?vJ#?b~iusX!{?2J&%X1rO(4kl#Aq~*4~$3OD^vg+2o`4 zcegjx@g&mM#__vXsO18UmQ`qAZEtgvg|RKD>E@rI<<3rF_8&dEkAII@ch?=9(_B2? z)^yZNjj!gQn;^d>rn|?m$MN#K0d5evoWF%%il$7QN$_v$W8)Z<<-BXW|DrS02%gOw zaYUcKOqUePt&r|~8&8uKIfRy{3Hs_k-aJbUxNFWeLEJd}!mOV6)It~Qv7qgFj*QNR96tBcEAv_vGPHFqZaVE?d5&r?J#R-ba_`#Tt+UTs13!#cUW6R? zOKZQ+d|C)nBHn3t_|tyj%fgZI6NtRj74dr2E3|k_kF3Yfs7O8*GVDD2jnFJio(LKB zt3VoAw14MRMgPLtKjrom&9!*Ac=Y~c_JvSXo8TOzxsjVP4fJig3Yr~5XV098555}dVGTOeyaxpmI)V`UD+OeiYn(nLf-q$be z+h5^t?{L1jv1KlV1{%>sC!x?VN5R4fdftie@nroOh&1WVZh%qB`tP-ch8K>#<0g$9 z6)xy*(r81rrXZsCYvDw);0703kxpSku5xE^MCvZyZ8lmIELQk#PiQ+j5%(a_`e1sN za_d0>8Zz=6+=La;sU1LOPCKxw=&)wo$;v9y&d-Ts)02q`mKYEgNZ_2l0!AD7YQWn> zt=@#1ik$=Sh6Op&Ki6>!tV0B`Hp8x=GnLKj0dHLJNJb@2!o%;7YxJ0=M}foD!) z^GUv*+L*u=@eSb#`C%PcbiT=$P=)yDXey5zArQy_kd$roP>Whb{} zU9q~8cc?4bU2Y&0s7#!@cu$DVkGkFksEpiLm~z)=+|IY&!|S6M5+YGYH%jTAh!eIE z_4qX%3u7Qg(F4qId)L*gAe97V5kuz zjJ{c=W;0hyG_EngTwvE~0TSraaAJi)po_N_@_rU}f@vrB#lVM!!$TJ3sv$iN%am*2 zYrSu(S1#_Ag{`Svssht4YtCC32lL^axFdSg<-0lUsn_$xS|4sR!-pucBWX+-ctkSM9**UfowBaeD}6*eJb zCj$&bF@`FLw&Ia|v7$Zo@;U4g- zk)(icw$5to9lgR|kXh1kDe4Sa7_Cee?7JL+6dPwbstZ8aR;+sEM=IbXmp@W0ARegR zQ(bB@kkl4#CQP**{^-|je^;V_v)3)#bX%&DU+Pii-T;<(1kmFWr1Z zwlo^;VE<~@1so%^>~Rf{z8L}fyNV+pWshkyH2YYKDqtfi01XVjYiRHefQ1TPgK$a4^mao88vyBgw_FvbV5D zE1Su{3sslCE>JMhZ|eOJ7TIHhKEr$N|joGw$ZU2%)%r%_+dpA`0Oq=Mi5H9F}VbMThG za?I|*m=XQ>E4dgJx*9L1a3xQOJIUU5}3-AK~HHMUygy*t|Dhd%?JV%`dl_29Y^MJePL}d2Pc*MK|g|@p0-zPc_GEBwD)NW~kOjyduZ!s({fRdmE}HDg1CdZnT``*z`ToSl}bQ z|B4%R0jpKLi8fNsGpfW#A<8W%`Nqz9m>omx)j8Lh@9dt{e0da@3@}c7MVrz86m9;4 zru^(mtkoO{#K^-tDcayTzN)YZ?iBTbSmUEwO~P3C>-Huc_tz3f03_%I z9QAkMz)>GAw0-?QFh#Wib$P6qF-uIE-0biTbjnSy5&cT5*6r;20V z)dZa#&kYBa44VK-JJX>*b208Lb9-Ohg;2lBXTCIe-7Rq>a~L(V=(ox+qSud1=f4&^ zCgq59x2xpB=kX3|}S9}>`fNhxkJKtyzZ&|o1+D+ou z5p2(R)g}O^z)AZAOw9`Nd)yEoU{X}NXmlDCx z9qM6wd>i+fwKj9&M6C(o{p+}JS6k{vqlehw(HTXQ0;@`9e_t|gg$ee^`w5ZjZy$1D zetu@WtZ%00B;Z{B$$@f3N9a6n(9{iR;VDJVLwtBOA3bgq^A3=0ANouw_S1PGdujaF zLS~4xxCrSz@o`l_6Xt+CnOcK2*f9XVs_Hk)`@IhBdduh>iBw6duM_YSn-pHWt!OBEd;koh*YAAamF zqIJ!M!KH9sDUlgM`UP|^PWTt|Z9ib@>lt1m&~6N7cFaJy1QgPbMQtTMAwTit({#5j z15YlO2$7OCJXZfX^MtgDj3DU4^nk>rO)wv>fzPGIjy&8$WH*Wop`70i^6+6Fu>S6e zd9OFAdg{^CB65h&>-jud#?3W=xAcXe*4Au1b5zvx%7ogL)#T!r`zQ6tbrsG%XXS zvGo!6FYFo1 z2ke;P`t5A5>X$nv-o?T6#JGFTQ-7SFE`+24e><88^bCPs3NvqH`jDH-%bOt<Axj!#=|8~0Uvh^LcW zV9@m)oqu^pE7?e*H|kYsgW8!>u3Up>fIWNW67sn7@%@1}4c3_=LwbbR)&<)es)!8c zVu&T)UKqJCdiI(9La{9jbrl&|)Q!Dm6!Nxkplxax-tdvC{kFZfJY&d($KXzsa9-l& zKCH$4X&`>2!Jh=XFW7q7>aneszPUBdJ`w+BRKqV}b!@qR<3!bXluUN~xV zdQ>&&Xojn9d-@JkXF*@VcmBb8@1MHMe-T@XHyHNgbAkLxF=nKbaVt_Ib(QBEipmmiQNqDP%P-2BU*Y`UyZrV5Q33>r4lM5l~b=Z?R{>b4l7|$Fs?gG7A14A!V zg~`N2Dzxi9F|P*(a528InM;0FLI#-VU$_jL4(fG3mWY$NXg!cgaH2@~)B#Uy(KP^x zmjjWjJwVUe#PCj(>pb;~Jpa~hXRO}>Kncg)?%0zdk`=kI!^hH%%?IP5Q~-7!r!$Yt z*1KhHhXuW{Sy`UUyZ*_JSBQwa-K82*@P9Z-F$YRNY!;jhQ~p zCHf7o*>C+LZKVGGq0NaHtsV&CgXN~@o@UjlpKcfYw7_`)^o;uy;q4w$+Tk$7hvC1S zYB4N}dO#OO75K}k(wmm)DKska%Q1M>(UnAY>x3M0#l;nJ7<#FmP%?!;xP;Las-;MM zR7sKk1vKdG?rW&)B z<%7f74-;*w+Pe?6T%#N~vEr`}2N_(-xvYY<9eZIe9TXt;DXuUHG2LN23Wzp~LKmmB zxDdUY3+Eqfl{Rg>y|S^I7(rZcLCw-w4F6(lYiq!?mg^L}hrAcShYFypNCs{l+dx@|NmNLgUP(cn zZ6b+etK&kkayV8v?giM;oVgq-gE-fXlY4c3~4Z5VGW zC-gE@$V0;I_2n*vA+=R&{XEx&>9{L9_o?Rv#79wo11JaLe)}l?gF>DD&WgRV>9ydn zYG0*2?5*`fP7I!@OmolpVAbE?a+g$J+;CcvF-wl8PtPD2wtYK?Q(;pyDix4PUJc4i zVP!9rx@3WoPGze5z`U;#CeSzXhb?!ORafR>nb>ELF-*~j!wmePnv|%ss1X!VEWoaZ zS?)X+csFV^8~%7(qbO?kVG*P|%gJNah|W^^R`Ht);8!W+wE!*Zxz^RA_ng^}J_ces zP2W~7xfpD>zjb=v^FjA*c(<)J5GP~t?$ahJ64Lg00B^GqP?r9#M8Q7l066x6v#2Y= zKaOb2Ms&SdAVeH6)O;&&4n^=4z==@u_&3-Y+&u~*;q_)V@W!hS|nwBHIE1LQCl zLY0(QXWS63{=NS}FV{wnPk1}ZylDH}Xs|rthK4y{(17p?T^s52RwP1OSi2p}DA@Jg zi;l!&>`Nt^&(iCS_GIZu<n^`bgT+T{$hwIfGQxc*#H=n+v z`Gc1Ua{$BNFka+{r+8d%eFShRXB=tc7GNE|+)KQ$FbfSBCe6U1JX>j)48~J0j*A6y zbBg#mNe;QXKf=u4T&n$l@1MV5dZ%}~U=ie7Wj}|kb947^?A>4GQ3B(%ZikmfR$mN; z{wS|Cp8T}&HM>CzfKb>u_cuvMtEDC#Oh|qCc`&Zj>%ZcmXsk&^(w?y`{x^6k1Z!q$ zpRru{X|qd*EMDSw@Ukm^dB>HuqOikjcF4KwD#c+ZAVDI3OP?00u0zD01>X}(*yrHG zGu`d9?ir@@5u5>{kK}`o!ukG)Y#R_m48kC7>|6PX=wXRYKDlH8x><}ea#cJohp8HH z)ZXZL&BEw^Mv6jN&--$vlYVnqza>3+MM$bUIb$PSOn|04sJu6gOFfSx{=~Szng7F? zUDIpT%3t8(r<=m2&%B%4ufH$d?s!bQ&B#xGJGO`6!%Swb$QD|SWiV|CletW1r#MnR z@=J-g=C1PZRkax?w%Gq{F?QtFmP+Y7L#bg+OV}PDY5@I6!QI?IRRfg8IbWNQVW7O(g-jGtePR2A! zdAsBV>?TIxLNi-qv%G$ZV1mAP*2k^ihBZ&;Aj1NENt%bBdim1!i!qDRF5NZ}P?KoQ z(DP`3W+RB3(f``ZkKMS^wR55usr~gTjo{c>CC8j>_`SB{&(H3dk;Dr#o%KoY%)VFd zp^9?aue-OVruM-64%*DJzqj%ZNd)o7Mn>On_ZNjZd+HTR!f==g^EBx71akMD0ib|n~orP(7XaJ)qlq-AXb_lwreFl1<)rvp2Blte`E6LR{s6Yw^Jwk z?10aESe-)m1Y_!x=iRC1^#^>;mRuI2&dD~Y$*`$)FvAuQd!`X~?^4WJC9CLJX}x0e zS7}QFp5Oqr&pU>yYxvC4$;v2>WY~-0lrtSh|3^Pr#k1I^UXz2?91%sEDhUYj9wvkk z6X~w@@JoM{Vp^!u4Cd)fFu~ok?tlD<{(=!O>l*;C(wY+ZLUuAc#rfz*%(_kELd%R> z%PHM8h^f(gy^qaM;00GjK{1+?>Dl4{_58~C-jLy|9OLX398o&Vxy;e)4SHTilx}O1 zxoN9jvd6L7&y1ESM}?etN+pH!rJbg-gN$__*3nQs$j3YDa4D|bKc`z)br?Z8L_?b+ zoME0v4E}-=3<>X#=A?XfhNo29%_o|L7!6-D+Mqd2dOSzqeP{Ppu9fqV((gB+fD<<- z3Y`lISJ&$uddI%pMM!pZ?y)?Yi=H@WXMbJ-Sg)5-UV0J_@X-=#i%qas71M4``Qgc= zIo(-1QAis-`dvG3Pxx4<2@OWbQ{7(T-V955Hf^8i{~mMym@gfA(5vs8tsi#eu9~Rv zCeAX{7Ck*}n4+lCSYJT)Sr`d)Z{(vvSV1P@r54rN>j@jyJ74xMPVL9|+=dAPmB^|B z<~{gbX7!_D#J%-gLGD1~ofT=3>ns}20a#AmmP}cd+|XtlK)Ed^#7&3e!ZZ?_9EIGE zMKUX=7Wl$cD|i6IH1sNk?MsJK<0o)ifJ4tU6AJT;_uZD z_n@0pEx-ytG{xxaNw^-E1R=eM=Kn5}B1v&(deI!I4o{Yk-2Rv$S5+hodE%ORoRQCj$!B9$h2D1{FlA)ICXhsrLV&WtU112 zTDoD5klOPVfE-9b^yHIn1dG_6J`oKiyw7#nGN3YtwbcGlye$NFHa4|CdMvBgtVd5S zwNqq%za-pnQqFjhyLEgYUHf-tu;0Weqk3xVphCa;?m}~hc6V^|^;zlTwB7jdpb;V@ z9eZ{_A;1G}#-vQU4&?qxIA__cu=f3%)&_NDnN865V%U~V_p0B|sqf7(61xh#JD>u~ z#McBYPMGs6SL(j}eyZbEDkgHkC=722EYoBKN?A z*N0@48?+nO>4zXAq9g#iVoi9G*SSYTx5NO#KsdsfWX6RX4AEEc{*}!a#0qJUv4^c` z6_JOadnLz1Z@#w~m}8{TM{r=Fp`6j+N5WHm*jt{0_pq-hG=e=at)#?!<*fgV++?nA z^3BF%JZ}D6;VTuZDW8#VkkBzyWse5qvK}vef42@#X$K&;V7xi^GzHt0S34oa+`{Mv zPV`O&Z~CEBz6OoEo^)Tg#siGb=xFizP*jMQA&cMBR-55Qdy&TcKx7k(>TFYc`LC|?rFI*;fJ4v6wfeDxs5OK+T5>$Q57!tY)$9~8#bN|iLi2Dl)Spr zH*@-Aod-m8&2xZa>Q20j2J8q;AZV%jq5755O1J<|E_t_Pwbi|3hTRlBH^Xa;JNgQ3 z*EJ&VhDUMc(;n_?^Y@ix1%=UrCqOijmct+HZbBTZvclQphW_)t1i%H)J@wCg>l>c? zeq2(MAgEd97Unc?alt?XbxhSJ8h)f=#8$L#D0EgVyfOZzvaM2n-@E{a$n-wros$B| zrvnC`c9aZdASw?>l+FGWWL`Cf?A#ObETZZdJrUuMxx@eS4?+1a&I9i71DwFlXiPR6 zZ*1EM)@fugne)>deiG@G<;}HWD&U@8T6Mr zODtpyTlZ<@E&S;WN+Zei`-xOOo8!_c{M$Y6Os2guNbWOfTRb}(6d3Y-dtYA)%F;yD z+J9XC^y=`a|H1DfmO5;_`?S%*cT52uDFLnVF=~Gjh%cc|o^FmazuQS`byIj`z1OR! zh!Q{(*`DUdbNOmENc`Y9!`0Lx_tvxeV_D(NG)!Z8`)9ck_k|(qX{&v95sDK~p5(jC zcV9qq7e86AFM>Am%ifHr|{nZS^zAmvsD zfOG4Iy)PK3RmPHg=Lfm#lTD19>XaF|?;%72(v77j$$yvKgW0OVkvpy$l*{HCT2z`( zOdX!abz}w`%@`qI{y`xM1ys0OUAlgcnIkVE5Zsjno>Hft z<@;=6O%SvG-DN0@NyP0*LvjBYd0%nmJ|ZRxpzXYr{^jqW^dHmQrUF&84$;A{5>#q; ze$Zdyt(%4L?wqo@CoSKSM+j`{CP}>Z+HQH8`*QsOTez zlXriAQ#F-gGq&}8bWmvT5BVfHU)s(%V5jRDQo_F1xMsg;j2#TCq&*Jx^#8{n>CvnX zVAZps;Ow*|OiuiA$*mCR_D*QLfrENsRqc~OsHJO*;M<8=X3R(Dw+Nqa zXH}zQ^TY6J7cjz^bUJ)upSZx95BIU`x%u)6u=ehf*`J?z_UtVHyEU;iAov6#Cdrio z$;E5CL|TJbbQ{0;5b=PXIRE^PsaUaCB-|NL{YfQ(hAKq0`NXL*3q){@-Av~*-zcYk zu-=`E=7^pk6so0>^q+oh*%BSTBNLp1`2#=vCf};^S273&lFB}#L(9wCK7WugoZfFX zxLL9NSO8`+rjchlIA8wLgf>i2mWf4(P%7H2SpV~40R)E}C+Nel7{!PQW5UOx5)5~e zZ!jVmU-GI$j!?ed$VM?vK`*F4Iv--GTid#-Qy+;to}gpbin5pD``~}Z<+FoBRBv3s zC{vrybyV5Su`Np15slplYA^h3J z0TaGSR3PD~nYv0C_{skGoVI_XdZ6xEOU}J65W?;j#zDQiHH55+DwguW#t;uR7ESTUXJ*iIbU<7Y38AZtqyb)8RyrT&ccGLy>6y#;J!jB-&m8Q`vH!fjU}Buxsn5) zrHW>O;;WA5TLv|T4x6-iHa%UAY7siXbCIA^`u;PhA6M^Uz`~6l$S=rOt;DE-Ob}AT z9}G4SuZ=_JyiAC4b>LQZjEiAWN}+)1-;~gBSQyAJ$ZyQFRorg0*>1VGFuDj|(OJ>r`%Z09pdAe@kSQUN91C&AUm zyqmk#{y0UI)y&06zJIb58zW&%^_JWQc7244Xh)U<|-o7~sk&$x*icRf!aZh-32T zjkhyE$Aa6ew?>4T2I8x!d2uM5-{XoI`o-iBa%#7_aqj(b|D_%xz!-Y^1pg4;ciVIs zZ|P-s4Qvd1hW?k>b1kHcHkLid4C%wf% znwR0Te-#PA(0QyR?NhfFQL9&q*D{#%WHCvglMu0%SzW$)!N&Zo2W=JHz^WyGOu$Ip zX7)^FgguaZ%15$feGZKRB`lpfY6qvgj3e6{Mf;H}67s~2ld)vhdysZrF-gwOnsQ2i z>9u4Ig9;0555&xO7O!92R>w`!!M0ioz3TE=7J;f1Bd9>|GbO;I8 z%Z_5K=6FldDk3)e0d7C7@@8k9w3oK>XVc}GRTN2f1{ zeCCgzErO6$nYV1Fg$d7hHQAO;Q6N=>JU=o3=sI4!0OJF}V_G7}1NYZA{@V~(ljKgF zpd;A?Am--x6=~Od&%4sdC8OqmB!uBtO#^R`zWW}d@R`^HIREAb`EVD=8A$bltX2F2 z*NumRq5rkBuc8?CwqZj_W9de{Eu%~nf4eRH$ZhZG5q8~uUoK4X1Im;TKh}oE!s>(FW31ZF<66f&!ppzjF>N zU5fAsXImGAJ<=_sVsRJFCY*K4tI~G@A+F$1xQnC#a__;N7u}|~g&ZmVtmDii8kT82 z$A4SlfTSJ@J8GjMrCIM`S`!(78r{5C(2jB+`u){MQwI&g9OvXB9e$Pv_ldvs>c*2gQp*N> zw&$WP>UQ_j@QWyoFMfQ8H%*KxTtj7+6H#7<${}X+2@zxToM}G!5RJ1cJ4=5Pmt2ag80)p@icaDL=Xc;(LS`zEL7`Aw#VqQ|Givkvu!mWvSVFZ1Zh zPL=E+r1K+_nl_uYV8Ym?4tsEsKo46|Bw_&LXgJ(*`$lQcV3T`IzZv&(wL^ZG24Mlk zC7qI6?(>oKsAJIculyG-Q?%Zi^P^VzkH;POF&QnJL`WM7c747aV9$w-qjtG=|L;A? zPvLMR8E}SK)nXAoA&tyk&R_G8VdZ%IF3cSDjKaNIXeKX+2)`hdP#}MKe7PbMzLort|Lzm zBYE0&Xv197a~vG@jWqv1o8VFohGLGe3?0&GwO})u`<3HuG`&`%#jmuzs`RX$Ig@VLNkxOB~U=8a?04_9vpFcJX!*pa-Gjk=@KH^YNr z_1EK%4Lg{*9*Jx^*#(6HY=^tU6(A2coY6P!MmuKGg#ve?#|!lOg@43D{=|s6t9E+( zDH}IJ?AIna5&iuuRYNlP+Z#-Q`FL|kAa@j`z*Y$D%rj`T_^YL!@gYZ~VLlQ;yJ~{j z<6(FYf&aU4+kzMWgIFAy%*WZ2MonIu<(!Mpx%W=&@CA`4kf{R)&{{67Y@8A`L8e30 zwzHr}21NyO_$m>$eScVje8kf=on^eFP@1n?hIQ*+%;Fv5F`4r+?=%lxfXX#)hSb?!SUGs{UyiYew1-7xXtY>j4%;uUcO4)l);0P_V zSY=LPDr}PCq*9_Jt%Xysp1vbN)Mn!^q}OH|_t9)8YD^aJD?OXd*lSUl`)E1aC8m&X zm4cn@Kwt)2l#Fj_;Lyt3`%m5qZNx5r)EJ*AF6w=HK-PAtjIkq>UC&=F5>1-%s7>c; zd0jXmd4>L}ca7)kNT<-vHpC4(C8=!Ih>M!ww>glJ?ev!_E}DKPfef1WC+r3*DE?ma z!s!jdt@5e(VCcPQojGB6bqFjw!t*+73SX7vt(7pA^+(6f6dr)nI$-}=bfS1_HCxpF z%b1mi1DT?A;2;+`8~VaLpY9p0*1QqZv6KdPfDmLF4Dy?Ew3EXrJ3TK#{zcZP zu_g~eMH)b7pC&Ro5^4_}jIq<_Djz!%0d2*HzARPM&BvsPM#Xuhimj&^J>B4#FBD-G#7s|BvU^CCO}0xy^cN;N@=k{Lv_5!2fFfx?`W~J4%WT$-vo3O|=E=S;8wCLmx~n(paJGwo}NIf6TKG24e3#LgAi{qMXpR4I0lYpFr=(dR`@YpC`? zKeD8)snvXK)m#RNut#a>My0eQgjaw75=ZnP`u)b1T=K~1IPC?#y$Zv3L2oL8|DBcK z-_J|h8cn{Bt{J6*)eFlm23>;I-37GOA4Yl5giV&6ri;HgMd9Z=;LV2l^coZuAY9Tc zb_h>%i`AnO(WY9<1Q_#!wT3q3J5xv3>eg3m+zUXmT~0{Rzfu!NpuSP@5t5LhqY;7| z+vlk^fzyFGM_OC6i7=l$Tjf?R{N?$6WlBn35bPjM zM!o*gk}R8^1Md&uM~6H@iFnp7-i4SOm!~GZ(DHqw{TYtkB4f9h_@`;BrCZqbK8Y}* zGv;oD{>4z1ZSY@9&4wecZL*+;1qz?q)C{z~)GKT8d4u+PY`BL~&uw$e0YO}AXB45{ zP6l+93jH$+8MC&Y0a4Y8e@eU0FWY@#$JDucQLa{zq)WGI$me}sZOA*=waz|ImT~J5 zo}9ifIuli%DL)r^h3rbjS}P*5;oF@ry)mx7*{yw%r-w=Abd0<`FLEXkW;pD=zal8Q zOQs09VgByrb@HeVBTAJDbkfS~Ju z!0VHHW(~LV=p^1VTOj(5`Qf+(TRHAbgo42j+x2vjy2VwH?-UbI!|5_KvCw}0tQSG! zcvx*Jdprm5q8>kRZT~m5uVR9SZUTYM015_*zPUVZz7X+)F{9G?E{zRAt-B+xBSD$M z6y^W*h`Z5Uep`@aNrd`7@k{G_pIMhR@}=M3FTMcscJTg+w-cRR*PU5~X0B;y3~Q9| zav$2o!?Diyo4zl?Dp(-o!<)Xi-`t9^wAj8cs(wTmkm zc2A|W1!yZI;oHz3i3aHm&lkK0$tJrG!?aH0V!yzjIwn|L(+_9S7*!T4cJ82+4Lm9s z>0V05fubV1_AKG0o{%<7gfLvGx?-UD+as}i!Y2#)yhAe)&xjE3YI~&OD2BEXLkV3W zomZ9oa9W+nE(05ii*zTn?b-Ir!OxN_0T?kk^C9QSaI=tw!B!6ASXprEs3hEE-5%&IV}3@`?9A=#5G$3o90PeXiYfee0mctbhUfk zFxNQT_QT&zlIMrghRO%;yCoRChDHkH4Eptx=WNZL|Hs~YhBdWqZJ<&F5djqt0Ra`I zNmH711O(|IO=^_hA|joT0HUHuQF`wJ(jvVR5CsA0C3H|a0U{*{BqZF$KHIa8`#axv z_n-Uk{#%gstToq|W6n9sJH{)K*Csd7F;3UW) z>k8}25v|{n+9Z~;{pT*2dfr}G(Kx@(y6Y9F_q}DTe!FeZF!^lMxip98Vv{GFR;cF=z2G3JjN^lgPU%119M zmtzWwAnv@QH!Ri66P~bA3yxQ6C|K-=NeYX0%J^@meVeQ|p%P5a3mqzkd?QY4TY?hy z$J%h(xI|LHoS0Mbr#CEeMomDWZNP~1PForVjq{f^Pw3@V&s>0xpn7ptoszhF1ndh9 zfHDqq;sy?i-8Ap6>{92#j8av8b>D+8u#58{ zBc&EIlfI2f^I!Id^$&tWQm)Sj~5&M6!w z@)eFCU1w07zS8}w;O9@qTMiM$+g25J1`=rNGQKtF#3?$V688Eh3o<}=P=KZEg^sWipAv^huQ`7tK;fY{f^IRv& ztA3PzE1SrYKA5jtw8Bo-Q}-4n?8ZcaYQcdU~edvk9%b>!QJOh=Z zsj7Rlrg;}RY}GPs;-XpCo)OF60VTF7jbWW}XXjr;xm0b6Ili3Q_cW*ooG0lHEwvGH zp3g+l`PBtCn$)p`ZGXz_KFJ4ri&)V$v}ZVUbU1d2zH=2;IQFIh%u1Y>nJ>1t z5bv-DwlUvq(s`)KzbA{H(8gSd0G0Y275(*UpN4}LTi zif7S$eq{ieeBx599sy+lkM@O{c&C{fpWe=C*o6X&$j|&AKf3e;v=a5q_akq}O{6J> zLhR#yFC^NPuP*~VYpC7{jr3)t46k9B4N{N(G)h*!PwQp%>Xw8_hpT9rG8g@4zDPM{ zk?f3{dYw3?ExmMhr>Kl>yHDQ(#+yLrOhCP~n_!t6pX-lWqKbN-YOC>!P}DIf?hn|@ zz4E%)3oc{%@yV}3&wZulfz4xHc{3dyv+UWWpvUI<>YqfW8}CN$%{?=G%H(%?)w;M; z$sc{qIZpW~beTb`e~o*O>16Jh@LLb|3tBDTCMcaBIXyAPl-{{t?6^zgeHdkL)j`99 zxH_@()l*{XYnHtshUtWe-hs6qt1{!x8Ykm-E>`SX1)DDvW&fef9*EW1_zrLaxZ|&gVuyAl)+1@$~ zm|qz?<@KC(ZGa@4e!~+ z{0yJ2>?`;e_CSZq+h@iKJ&+lzM>NJk2g7QoMk+apZs{uKH&k2$J(FbsGK+hVGf$#6 zEu69@pDa7=&vNWep&bkn1toN~%n@&;HeENuQBq+R*z(ykix4Ud3@8>Yg&^FLhhk)F zcYWF9_*!E>sYyt1P|mW^TO;=1x0)OM=Thk}9Nn1eu_l=8Z4j?*??3tD4>Q@(OeQ+y*C`X1j-P9*%Fll$`9IWvyi;eic>sX zJoo`Zj?R)M8MWC%s~;iq?joKLeiCcHC4S$cQ(=>gZO->=pIvRSf6CyhfIg710v!xcgUcGy#y^C9tMy+kCx{~%;Vyf!@ena zO6#JYPVV{{#)zsxcWikKXFJj-9#g$sTy}EhMbQ@i81Rx{W1BPc<3v` zz1e`l7b}wlM}tVuKFJo&o*%>o)a{ciYkmvdE&Bt9R)h?&+X$r6Gia<|6g=Is7xQK@ ztx~U6KAiS3*M=vDqcyu&weOCZV+QAj!%~GcpF(ccISuwWYse;e3S~|ay{G=BMQu-O zzb7IW*2c*vs)R&}=zyRH{{9nrbz_iBDy-{Z)`?~oCzUUywbKuy9a-XjA}Z=wTrLMw zQ8^7Ztb2eXT&#F6(U>}ukHW$?9-XM0XvR)TD4_@u-}3z6 z&Ne_@jpAQPo+b8ba|dPR^vuZ-0}ebUyr!JstQ6Cc%hft392~_ggE?y- zA6N<36!KfD3g-qW`4;VY2Qc9Rc%gYZ9?_f+U8+ATY3_~J@EZGUXvA{Fuw4F-nXMv& zO?X4#xWV>TKP9JaL?m^t(OQ(XhewapLuy&4lwN~je9KZFH}rWmboUG_pdO@X%}7hcA+~R(V44eI_v_~ot0SC(fMj6m80A2&LVC^4c*yCL3910L8+?)WO%998IX_f zo3=n-4mhqDp)n87?78PFKm+{QqN?8+Qp9RmC}U*P#ul3HtZ&i9zEDD$*4Sqs5=#X8N(D({ zLT>`r6;v=Sf^dR^ne;~xrKZ4HhZe7H+H~PHP65A0gWQhE48r8_VR`2kp9xsu@TY5R zl=th+Y*>$wDSp~#Z3xlJg&5Xez^K7*Dq^B-=}z6=`5H<~e3t_fo`$$vf8Lc|IV1KV zXs46Klgn->Z;fZiy(%5^O$?XJN0{9DlCf5h5zsE4TCXOf6{7mw2Xj6I z5;ooQeP?9g4K+a9h&}~K;lcU$&5l#g7&SCxRfPbm8Tb1;i$^!}+i#v>^GZs4@=T-M zk!_1M!7&rs6L_xfEj`Eep4BpGd7x0)^J3Zzikr4HAF?b`Q3o?y8Vi-#)DL+ z7AEbQkasdQ)>^yQEweguu4%U?E0U-SRjECo#*_gTS3_*^H5`Y#GH~ zwyZThL!F1wu=?q4N<&IEQ%R%FQWwI9Zg{o+s1-VWk^o872rZE}#E?ewb#C6te3@v9<#b8X5gY-1T=$2{tEv|RveVMCNwED3=65nyN zd`P&?Hu9W6n-bkODB?zncA7J2FX?dnFDMybgZZX;%|gvfJ4S%vZ2SrKm?hvzW~zB&{w zB&WeE2wj=&+p?ucYiLUu!ElFrgZ&0zOZpn8thmRBwm_4$CzNd3S*(z5fVB5><*oGs z&}La?&=yUz=ukOcMdo8+(lC*lSNjwbNyp^BJ&J#>&_qD+(ci@ zPJss{fyY07!Ez4n0j;MxSX_}Q&PtG-&M#jkJ?ZXxy>BE3fV>h0A7#PfbqaV<10ebdqed_x46y<;Iho z*9CcH7&P_bDJ-isSf8`tHeqOvKmF0|6iMgvqD#$^CRR@d5#Mk_shhY0#XzY~R5UCr zekE@J-bJSCt#b``Y058!taG>Oli#t{0@saY;7Yqi2+nUMZZxG}FS$-h?w>+FgA8O* z6Zwk)0+$GlM5DuU;hrLe4VJ%n7DFCV@@Oa7g_3*C7=~&mUit?K{8bDGLga$3YNs=?~p~>taoK$n~M(X z!`3Oqq1E(aAHCL|Hukt4LEm%Ol+2SP_~y5HGb`_qHE0`_x-N^J2E=#Pg^V;tSItLI z$=W&1L@F)a8H-Q(on)Pv=jT+C2X>t8mF!4_mCl_%2qv@gPdlyey^iIX8g`#6E8Sb4 z$j!e$Qn#xB#~IvmU6_kWs<3h>JF+M{+SXZ{DJk`G8BrEL@zB#eT-&17GQoY$37j$l zzRbYs8`3`?!WOn7^IaBQ_r-3yuE)U$N=Rq0TOV40qx#07>W4qcGw+UXqM(BfIm~IMsL^8I{2D((1a1HqjuTN4PTN z1lt)=lO34e)67DuGt-Lua<7XGk@Bg|+yGw;!@+#B)Y2@0D-I|d?golvHljt+cKcL%9rI9!=+pkJeO!2Vf{Q%f0^o7&hC&ND{*&j`h&%*56|35*H+IYJ>&^Hq zH6yZrX+b#S*WTWDw0(-5Ci7K>VJ4P$Z$Eu;N);I%L#-Wp^wLV>mcyvrfvkU}+f=0% zz<&AOFpzd_tnR(nYj=KVs_)x-vCbc^YKaV=KsT98Rl6F#Gv@blEA4;PuNWuox!fg! zhykVOinH&O$>G{22gtrQ1*WiG}SpNK5I6~@lpOi*1f<-cTj_Nn)rl`xXXw>6{pWBQ3c8if|i0n z@7)@$D4C~OpF2A658jyl;xqn@^Y@R<4q$;IW%R0ROmP zr3`?KG2{%`r)fMQBNEPCoL9$Bxd+7!+ICF7=L*{Q$!-lM5^y~uABNu>1gZcW?6sNA zqU<5v{Q4R2xg9x^rICD-|M`BUpMVBax_?Re^^;OEjT43G(;fQ8BN^}YdzO}=Z#hs! z#bH{?KV)9NdiB;oF_0hNIH#XznJ`#ANy7ao26`6cZbW4U{Fd>fA81EDnOvAxRvrij!gekm-V41TS&{){b>7K^%eVr z4=s*8$^Us;D(Rd980PaWo%uF<$>mN! zf9NW|*H9U^ag8BSVcn;mp7vuK^%XwgXLk1XU5X+tt!7p*;->FJy=MUw)^@ORPgV7~ zV>0|TtC&OAbB$R0g^u0|ceKLVU~Vb^A=1KQHiddqBrw$)Usr^z8Z0{w6?Df+r!IGO z$>v!T1BQz1X<2VAUS#zfze3jER_@sdp3Asa>CpQQnC|YZ+~~M6D_NGJ-3t2~5#KMF zRZ1G1XB^W=UzNcIdJ}DiCq*LI7yQ zQ9BK^=0BVFK_1vIObc1n4V-R(!#|hg~KMtF?wqV z5d>NTsB0@-K5%N`@e>W+sS!uEIr7*xYFy%DtH$v)pgDY3%=;eIM3B$gUEmBhEQDp( z`MmIPaWMMq+9jQD?b}RBPENk{_)wLQGFjnW{5ZDAFu z>}`GsG}}AR!6;-U%pg|o-DQ!p&Ac5FPM6cQ zn=zaPxWXSy(8xpl)Wt@PF#64px(TRJ*Jw)J4*A{2pm_7UbhoQ=TRqM3Np2%m=@#8krd? zG*DR^FKDcz{ZpKW1nzY5x@UVQp_k;Y0>GJG1kBz6lmK0#&iSAy1`uKVwweg?l zcZkiYW7oZUVZruIIdidzT1aeI`gMMOezM~H$f16D!gI%T-#Nm)J@uZI%ocYFGS0w# zkHMELLg1;IckV6t5nWVJqNPu@(?U@~S8T^UfNo*atL><2@NkyE$pp5;7=QZoX|YV! z{hepO^f1z9IJoX^-))p~qnpwZY-cQ0gkUK$pbdV2K!=3c59RU0Ol4QIT6PdC8E=6o z1i^CUV>|WKK_@4qN^W-~cjt!|ya%XHa!U7VvyCR1>PklP>JEw!=KOZ$57tp=RrY>p zyd>DXN7lXBhW!Lo2N*D=0_5}mlw z7^!I&1_%KxmGTlDyQp{sHF8LzVl6lX-1VV4kEY!b$&u$jCjEULJj}Ujt<`t4IvZ2( z$d&kAYF3!`g0QfDWm5r*m0#Jk4=NJ-S~6nRZ#Nx==5@^UZkP_}p#z#4b7T^pI>7J~ z_aH$YQqQD&_R0a8xSjQ${;8MuaDk3811M9Z#~ebz??`9rBWz`c;g#h53xYR!J}yh{ zn%`d7Go%%+=)4S$Sd*Zc6QIj>{(a% zMy=)`OTV`Itr>{U(N2$(|6+N;W)piELXG5opxB(y2+C~>><9pFtY|o+qx&99WG&#o z*CuDxH}yjtTL=d5C2%c03p8^7M)sthGu%R1IVUaX`%+B`KAAWz7ELIwpxcmLXeGGJ zx2p6)SEb?JGsx0B+y!4~laKZM>sen6N$YoSp(sUZa3-T@lGOn8%Vy0wO(X7n-kr_+ zs{Ij3P%kt?a$3siE!W;)s~zP})2iC}+-P}Q$TPeJZ_>eJ`qnOMp z?2@qkhOCG6OKxsW}6{P2^Q#W%9B9C*%Y5LJKB(GT#Wqs?BpBp47?tz z_S${qt2;E@Tt5ccbKHM5s&PxojN50Tgt{4mIlH+zKDzgHt_9k7C>c<)>ff@r!@evh z)h+KkXJRCAT8III;^pNveO$l!*aEIhEi1}xgzTFm(e{bJkujdrmlzSmIcl!jJ7g)> z??5P!64Cg8Awf2C@!)Hck|y->Ucu8ogyxupnkfgPpVeiO4z4QSXMC4Vf^K(uD7GB6 z@$O({xyH>>n6rG*8AJVhl5>s$Wv&;<^U6+4sl=?(WVzSsVIq{+i_7T;1#P|v zj%>xxBGwWb-Sm|#)4I+-thni9R>{-m;55)e&W$)!bGbVjlll_mn#hdF%s^nf$Ih_e z>$A<=@YuCYPcbOmrRKa4TV4JH?ez7L71XS+bAie>D|-hR+_3UT(g}Iuw_(WVc7{2$SfhF&)-V}vp)rR(_wHTB+>Jd?tDw2ToRC+8Ja66_ zuBW&OGW}BDKg{tgfn#Tr8P4Xd_Am21#D)9k1TT8RbC7dpGS%>n!zsVRa_UVlgCl1K zZ5?Pa$Q<;9G$BcBkSt@aZ6b9vW@H7U;Em>G`^f9ojRW(+-=$_A0oaA@<;I~>i^Qvj z>X6OLuXq^_R}A#@TMt&!?E^l7K!vy>>|Wr;Ye#VC7+pRu#*|wTJ9RmqE&`-SnB_Dx z^yjj*l$i1Dr1y`sX;5MxOUpX3`6!^L7s=f+VBXBDL0kL`2`%_{n5_gL(Vf2t0F5%waO?1UOJ`_uH^ryA#1@ zGw)IR;pJp~%f_p^J(YD$)>;`9DKs2-Wp*PGpuc1N)?~4qJQ0JzPON~sQSME)iLNT7 zFfN!2g>MygaZ6Bo$q65;Sh9KV-HcJFb1v4*k<^aG`*LX&R8v>PzE)*ln+rnI!8gt{ zG;gg8>#2_`B@=WU7&hZAQgY}vW#qajaC1u%BO&y!f37a{``rpVM87ay8W5q{-(cn1 z*w%swg5A7d`a6MN%J}WQI~s4L!EH-ahDxpm5p}Hl{csfz3or^fchuOJve&+I!G4mI z(G!t8<0}XTdEqxKBFw#KvdB16KD2@kY(67-47KB?{lgprrQ1FGM_lnC{+ms^TVX!K z=Ny`c^;}Xiv8twjGPDo^04C`j}iMD z&;y)=>8t!7bTtN@-v=}536(#RroT)lyl* zvgV!QIA*4-8|&j6ledfSQrtezh@5aa|78Dn>Zf!&LY#GG)<<6LC*sbuHdVGLa;_8`9~qhzdXAD#{%434!U*dWxQ@?HP#G zi`$xM40tA~?7jI+zH=u)s2-JzRPHB?S-ga>;l1mv;aVc~`d%BJ1x}I-9Goh{7P5E9 zGQ4{UOL>gDFZ%|dQ6y+uWim3irAERJsEM@Qa2=Po3oR?W!-kg`%%-dolw_4NDK!Td zXyG$6-q6$Lpl|vPDiw70zU9*87=zEv)69FoP1DwfE@@E+rhS+9Qe;r@17&BODAhu= zG%qbBW^Bt^YKdZ?=;mnocIs(gbh^S^WdI^z_KZkw^0lgniwD(qc6R$S&DOqjRYSoy znxk|Fotsx&MN=;HPX3q1uUHBm(80wuRYmWaT^4u zh}+R{R|4!R_<&cgmSx4`rJixuY6rw0!3(w?20QWHu7(6Tn`6pmIa~@ zwwJNRtXF4eH*Dp!3*KHD3bJ0Mk$bW%9X)xfV8JZWckq!w zm6MAzSP5$^Zrn(fVCnzm{dp8y$0uaN$(8soD0TQuys4#4SPY+^9F()jb;WhAWjP+{ z`eD9Y0uqYIkw?tjg=Zq3M!C*-pCq?P1B>TzWIXHIqH48$Eqlqxwv;@J{D&xzW>$qL=*xuvnv5U z7(wiidp0CzE2L3Da58;W4vbH>zzs81&SL3zUvNt3Ylz+5zv0-Bz>GYIqaYJVIoFCL zKA4l${TMRoq#tV7y&jlO4Es@Dm06zMph$wvi`{2$5^#kQEe$w&Jn z(y{NN$|mT^nRN^=an11!2wVY;A@^*?a+){L4JfkI91uI|^o3375`L6KQjVaehqWRG zh1?Ynz!zy1mZig?gj7>b_;p-)^-2(sSDdbF%AabmuAF=|JK0oo7+(Y4Npu$28DjF4 zjEIY~dOs2GbyEdGDX^txhm*fLAW2GyUw$xE^LTfo2HIGY;T*&mc4>NUE+=?b>ha{Y ziHQlHbRb$lZD|VBsIq$n%mf^TFs94+{Oks{vqmkH$pJi?jz?C-Bi!M{K!=l%Oqx>L zE%(`HhmR;DWJ_`R9`(^!HN*R{Hk0zHQo(_g#*2FfW^IgzL zcOOG|(V_Sc^ zIXFGiB=yD|IicsEmVdlxL346jaH-@aRv!v5PT1`wd05-3y0(`{Iz-&uRXkiZlvVTo zND$l#sFyyVi_k?6|Jcf%$J4P(?ypv1qq~Yl$vm zUiyY5T(shyL|0Ti$fD1L9hNoy{Nc)T`B4Rj?qwk%9e{hyA!sjYk^)nArL$Y{$UlT~ zn0wNyA2{Hu+`c0UnmAUMy1yPC9{e@gM$TUjK7h#u2+wzw^~rugAm` z?FSWEzqsW2?JWl=V!u28D|$S;xr{UBJYUk4Yt&CR^MH`7^(WN#zQuFr&V4UxMr+`j zZ}IYq3&|pmP_Y93d@o`oI)2%P^%f!BXDr9{8 zFeBqm$(AQGSd@gRo!hLKZ4UTq%=11F(E?S4aJW$H0AAP9f}TPmZ)U*k3O3%`A=GC4 z^B0M?=I{JfPBM8bc+f3`n_r*bvFu`acB;$rDWvzuW9q-ZLrL zpK`b}K-J8pPP7SC;q>1pW4!i6dq7>}4N}j;8oA`LDS&e2UwvcrIUJ>f--m2L2Abx4 z-_UD4*}l8dvvzcmXVTTGlH6^w$_z%buL?XE^}Pkfmt4h~5HEy zk}eqc9E3)5T)R0qn3K%xb(@S=^x@X@K}<}HO~3!@Ky1-sJJruK#+M`r z4)$L?I=e-9{1*GWf?nsBL`&lK06Tb+dmZZd_TUo#1K^aLk)NdHG|VhWC0KrZFaF1A zxlYurR9W?}534?fy_ALlOq*MckIOb>b<<}6Jo4IBf%e}5=5b1w5hxWJNrz)J&Yyl> zkl1S?>Dc9mTX?EG7GrwK5!4K^_x5)ES zJEjzQ^{OMs8F>z!aRJjFp?A>|C*L&oZF%z7W$aEjM?oyCIFVT)l__phH8WzHuAiE@ zKs_oFB1SlM4wI`b2G&oyUt&TOxvIB{P2lC3(RkJa6x>#>fU$^Jw;5XQ1z(soxiQvi zhw{)gKni)xP&pcN{>tL~>4|9a0p zQ59t58Fb3G2Mc^f`ey+$+_hw^MENmWW&P9m5-Bpu_Zqv?r4W|>Eue^S5%?|p!-zX# zSD}703Sz%er`Tk&HdR}@;@@VUagv%RpCn-gtUcO3VeIZhkVubdNnCrhTpuYAM=T8P zl(w1A&RF{J;X}rn5+gGPPcvFg>-G4HnaRYuVOj&KfnU~lQio0Qn|t1FEyE^<^|0nl zgZI*E?oL2c@u)01a6WOqvR|$H@PL*m%utnOT%7R3jyFllJ)8GUC<0tX1{hU`T6Yu3 zcoxDL=OuhLxNbQ{v8v6tqFjLBKh#7hZe^+l%-(-9K?t;#EPOjV#JtQZjv3NzoGWdEU3o~dtL`*Il<1%!DgcFk&G&{ntOR0+M` zY_|2qjTN`T=pNE9W&T6lAr(xQMK9l*>56qs*((~hA1!*WY(Z&m;$-je?+~{FrFoUp zarA0G%tnsa!wxCwD&!5mY90sBFB~OZ{D~Jb zZ~AP=F(aIG-vFMeZ`Js)?`D#>fCco~he}BLW2@aQ3K|-e9S{-3U4^e{?~(}64L`WQ z#8MX!^Gsas-Q5}n4#i2T)4c$TQo#GXyssM*o|{dkpdbtLOAp|6lGqHN?k*oOx<3Df zUSHytau_K|0h(YnTkYyNm>Di;jssk*hs9ZKR&&I+EU)s~$SJf<&V#PUtrVMaq+L-1 zdJa7#XAG1gMFTF}K`N{ozWzMWnhzcAnC6jE024{>KSvbYGZrUA!d|*KPgK0hVpqz4OX!LK{A%KB8SRhN%MB&Vz)Ef9jl-G0`cDR)Ml zIDCsTDw0h?x8(>{C1{zH`50-&KTx5QT9dNb@pWgZIBnEl^;Zz#G>y|~_kuwU!~;&) z!sgBa3n=Ag3h(&r_6x~VgAtrFjhe2*TE=f+Yg@Xq8<&)W^zcCNWeFp7D0N>Nm9Tdc zh+Jm);|*TlT5G^1l~;Qg2H!+Pvw*dcIdn0Tw74SImk>E&z`YqP@7FTq#G|1+D5Vmx zC}In5VIQMGR<=@nH&kpng(_d2D@bjb>nq=r9gR*cf)BWvega7S`0stEma|m?1+{~B zKCDTky{+rp(i-MQc^|I4H=XbgXc|fY*8aP9?|38*&qC_VDwn&1NQ5M}Cz0>UR*EKA zW+6wmtT%Vq8)pX{1b@f`GaS}Is^cGr%-iDy-+jUL% zf(kfKxeTbG09x9~^|Zhtn)4SfEZ4eZ%Yb_AJSN_=_(yq8ap1ZD4Hil1unrYGMjtT9 zA3kq7>`uk9`I`u~zt*4SioSg)TEE`i;|69Cu@*43^lo-K@mwt2xMhuQur94xyR zOF6Xt63utqfp{B9uM-OEh!6={8kI`A+(_pp!@NCYS> zfPE+)%vG22M@6#O@9X%6WAV+XjHB`Lj}k%{V1L-~NDsXP+t1#a4?=rq1jus+9X`~M zlrNP?4Ur6Q#!p&c)gdM_m@&F412r-Fz@0S~>#4*=jgRm|2)bECGAV9|Z90qWbdYw^ zH6e5H#E$JqyWUCF*fP0ZPd}Xlt2DKa@Id18^+|u-mN>>^&6Q3U({Z=kB$m;=nG6nC zo?v-R^{UEwraQk9bbu4s#of0Kz>4WA8pAGOv^;!3;4$N9DeEAE*}z@-L2=U7H(@%q z&)sVsYV7W&W&4evS4!G1$Q^AkK0VHuVM!TsOCp3^vJ;cz#UB>abL1BR`X1f2nc^_9 zVr4D~zMMuHNl)t==Bz>Or*1RTEge_~biI%i>rRoNiOI;=>JnbKq{T(e>GR6cW~^~- zS$3wf$4+Jh*Le(jJdo>(XHdkCNG5?GL?OvlWkv3pcEm`rscD87JUg`aCw+@1AC|Ej zm5-6z9LYWg7=pbKhwB!DT)upE+#bSyy#EpOY$auuNaKi+=eb9h+{oF zLqNWFkG1lenAor5&~*KJptnS$yLO6l8w)(n4LVHkyj;d-(^X= zadfzHGQSobw$-aC$FYIB%gzWAlTQyK9Z02iDY3JsbII3b7y=ONC1pb(Y%BEm1F%gN zmRWi9Pt4%~Wh1SxxstdUW<M_>?AE6Pm1A?SpW7&AH#|01 zr)xmjlUrK*V|4T`P!?=K@p~~xq!rG=`QRO4-=q>+t46PyWb(1p6S7c|3xfCq1-qX& zZ$0{vDM=AaC4K*Q8>|~BbI2*};hk=Xpj3-wa~)#Rt(I@hfNa4K>SomfcdUbmjD#hn zFnX}t6Q#CzLqp$GMP*#F;_Xx>%WJ+fm^@<4{z17^ zM)5B*&*tdRbT^3UgembuKKPr zoPsO{^-DG}YcFuE2fW{y=BLSLA^Hqcd~A`hz@_l_>ky$>|K8nKG@x*P$*rnM2xK z8}M|?3R%r%)zo!j-!!r|A0&wUM7bk+0CU{g(K2w*KW9Q-(_EaQYkkz!zSw`x!NK94 zp(kjJkmbNv7_n3gM~KN|K;_1b02C`ced4;&3eY75Sz_fXLj#mUI22|8H6LB$DXVRJ=beLk<$xZ{AQ)$_ zq6K8C^s}!Ff+vOFZa_i`2}{KDZgDao3Q zwFwZs(2Ci$o@DSqRQ67}PiyzTW98DPoiu-B$Tv=9K9wu!S8+zS?rdEd2jEm}*yvre z%!iKa=%h(QlOO?$!3Jk;cQc7SlSLFS6H+)1SzIy7JMKArB4NxS0z%AQq;;}ISy%>a6fr=AO4(`8ppeei~(|VeFK?A`fAafuEig4DY1Go+2h9aqX%lKYD)mV zW<1lzG$%sx6oy!?5{AuDd@sZy69+q1aeT`3Yo%)siqNLzsL+2)t^KS3U{*pk5?NDbDS;{%lbD$M8|Cyeg$16s2}y51 zw(X5g@_3`vQau78N!w19+FplL!`#;f^L%G)!laz0YT|)#WbxO+U3myLCByl(!xZI2 zqtwjaD<}63IM}^kB^T$|Z*3PnQEH*y2!exEsg|`CQvY~&e;nTh%Pxr8% z!qsY5q;ORWHi=7ii$NA-7?JrPw1W+4gaR5#SFXVJTU9pCGQ9{+`W@SIY?Uzc=;x9j z@932SK-+?!K%OMo*}2gkurquPmJ&1BD_Vn{hnKt4q~B$hnS@Hy*y?ruzEv zk&4`k4`!6*{Kffqw&cHk7oYk3PLFWHhajCq3D@(gV&s-y+sw=8#ulHt_>S%Eibo4P zyR|cRdhK-%OMY7uoj2V05_0=InpPG3#-Egja60SjZrNYsnI;+BAg)(L=E5smo zXGlWw@$@}<={&gjxmH^754fK7Wg>o;{^|88G`5{Lpm%i-QIBpFS&s zfr37Y!^56cW!Zt?5XX#wyic7~B1Yx6GH&95(7>^4J#HHXkbRc_PnWkHN>!@qGE9&8WI13 zHnFQa-qr57Y|IZ~mG&hjE$!-D;BGN=w$WGW0Ey@mv$b9Z4H@dm_X%gp`R6;b^Zd4P zlTn6?oMmL>KF$wayH+OFHi7sGz!2?v#=s8u>WIgPv$fIU#=VU}D|&@GgsR%|k(J3I zw{f%3eM7@zyj!IraER|oe^VZnz2Oq^o6`nhfHCI_CFe}+92~k!YZcD_T=znaX_U3# zpJ^udZAXad?g6UEI4BZ(T#F`XUNue6`1b9`*&Ct{G3%_&?y9WO-x+JpXl-E}4>pw44Da2Ruax*_0kJ}WbD+~u$PKTTu)yQYk)UT#WB zQ`awe_x9r*9^JIZ5HHH=JJMx&@+4?H5cj(0<_2v98r0gsjmJvN95XvRrQ+)99>DGU zVn2Qq9rk=*yc_r17W#Y8{g-S**m(58x2RO_-t7|WpGNKOY)&V;yks1|41f*pzz&ue zl4ZOBj-uYXF9KEx({+~|#>%Xw=&#SC^~=jKc0jsZLr)K9ZjTzfMz9Q}CXdH%T2PyR zyY-)Y_y6)@7eW2fTU1V(P>^CI+ZT-^Qu9*HRGFkaiv1PUX~22zk6*4(Q>AP7@*lw^wazOym@3^(`gd4-L+ zOy-|*w{G2{5O%!schUcC(ttmeFwBJpA!Grpsp8Iy^(kFl{26OSw+Cy$S{9o?6Ftfj zQi9ObKYx@*2pIsll{XbrXvubL5YYA77#}l{m5|UeDYHcFGKr_QE_PK03fuDhlaa9; zkL(!SYOiU{?GI>$^FS6XzU33!#jKU=y>T0XT%cORtFC&kNKFp#{sysYW6{uqF^#vWp)R5diawHkx46DqW&7NZWT>d1HB z+eKnctq=6Q9y|vMxIsV^OCXY6D$c6W2LLHqsESdY;S8+PP7*CGO6SDf{cmsl{eP!I zl&WdY47i=BoxwW2y9T65p6+yYY65B!Zdof(GSKADSpWT{miJ^3_v9|5x>rzraLB`@lK&gS3OKI>5 z5eyiN5{#{TYo6By1+}Rd6qHjWBXRykm5w46yROKn7$Ciew+u`Ee-*+B@=-&erb-~t z%A&?iKr5jHn7JXlwrBQF50+NOuTWm)-W5gxq~=R2nVmg3cY8L?0GD|X0C;W+1a=s4 z{9oVxFHvOGk)OG)Z&|KcL+XgMSe)@yzo*$PY*G2@)hTD7NdW+7*LwOi+|JQa%g?V4 z$QkOhim!guG=UU_9#5D4eX^J5`955l`p-In-{(<(m-5t^LMo)C7zF@5w*V5Bj-g~} zhT+lfe1LrvlN%+YD&zYY{cZW&AL`9^3V@Z-312PvU-A0EO42mIJ-P!+-boP=XC~^! zfTA`y@6DToOWqHn{xz(=<8mdj+hKptApNDwS*K|i>C`|k^n!~Zv?IXgdFJ}SX9!RK zpKC2^oLobt;R1wR@((fbS%h>jnj~zJjm!Sex!2b@`Kfr#-^2VL%;u@f4*_w^+yC!h z_m}jPBrX8;7Hl9(-G5U31*FFO=zb3&{rBedB-^ilNTV-x=$!x2{s^?D&mV$Kpv%uR)K^3d#3#>xV(m#&`TxK3_r9lZ z`wQd%cva^A54)5PLu7_!{gqOyyMbSsYrG?<`v05B%HctKVlkv@lJ_5*7-WT#PovY* z6)6ves-U+d;sn*6h9wp4_V;W4mt_K@{$i_r-Q=bJ+q9$|9UZiP?K};`03V&yzL4yH z_dAPVpp9bPFLCsrhWpnQ|LqfK5rfv{)4I#izZ>k|F3l+dT9^2aiM$g3_K^QF%zu0e z%w#~*aZ&0qv+T7$=E`VyFQB~Gr00Jumhpb{v%*zV${glM7}E7<5^f>4rali_q|8XF z7x(72vGiL{LrSmtpWgp}`=2Pi@@KtzIgxe;|I%)L0Cz^4m0LkgTXAW`2jgZEsS)$5 zTCL#4r_-fogMx=jKn&{f8?%kOZ6dr4_9#P{0ZR*ojmDGO(c6E!?7#mBTKJ$nhL-lt z!=h7w*Q(f7am!@oYQDXMaIrACInIvJt>|pDbkR(P0}qP2#(>cZ4{#7lw=<>@p3NxL zdWrXQyK07B0YpRV4+xukpsWnDP$(DDO8)#`Sr-4p@1BwW^}AZPO)vX)$|Bm@>Dg=h za4%9%frSf-r;FvGNJ-o5<-R0dF2gg8ZcmCYo>x4lggdI4%dsw+RgdvNA+z-CMX!Kn zc5qDlJZt~o*`$9jr2p<2{?pdVkiJ{`>!`S96-)IcmFVPfuD&FM8f=} ztZs!xz#;|G=TXD>F&Z>wV}AXC6j`CMVbA4%XDu_e$`EUcFFjLg_kLw9ryEr*zipgG zvRx`w5cX)ku_7Zn4w@+w#wtBCo+3H-P@>i3K3}E-3-4jh?ue3*n#|;1qi3D>XtivJ zpZUP)XmZ->melN#hV*T1?W(BxL9f@h2Sm+Z$h{`3>EsK4@?Pwm{ER}NmOP1u#7{Z6 z$lYrX$y=;}V@0wuX=C8qNNyE8)}KJ`rb3}x|G&41oN*5_dx$<`YEeJ!G`w z93sHH*`H-7ejwbwPP7RM0v_8xtGEBQ`Tk|`$~w?Cl+f3++gvFeg7~)Y$|^z7!O1E@ zFp!op{1iOp!c>*SJ;uUdA*1hV;AOJf_ijP_?DY#NBePvy_a|49>EsOvK$st-bQGJ+ zOQ6NuBoJ?^HTAjYA#2Pacslh2G7xTB6dB^#aatR2|5!AW#7U=jP{g}$=5Zv%UuPFw z%Eg-B`~diDlK7YWL*@t<2l9I;BqWBred?2Cd?IpJQg)>mvA>Rx8VAKtA58X1Mj0kP z7@PARrIj+jq#@rWU!D1@*+bkENVsz6^1B;|W+;qM^V#>^`NezA45W11Er3`viuAv_ zjeL9%B?E1@@F;!zgzmKK5`XIK7qs?*kIF*l%Q^M6+ykRPp&cp#ZoSJ6@djqEPcm1o z`E&>j=A_{4jeoJu4jmt`Lbxx5se(?mO_PYX=UBwb(tA}ZOltJiVB@gN{Igk&mAJpx zI;t~3<@nP$`|gEhk5vlLeoTFAdaR-8Ok7e%+;ckuqog9Q$=^SI{TvtxPhnRtZj-EG z@@++|xWsEQ2G*a(E-6oIGDXG)CnGF zwpk;@1@{*;=+6+L(-`xD`fR) zPkE$F>~)I4sZX|y71oCK`Y>mr8-LrxBr?NKE#m+#`|HoKhb9&b3O?5V={Qcm>w&=W=CES$&1_2>p^izIV>n*DK!RlQMY;SFzTfSv)Q_bV}N`Jr_0q}<$3ZLQNP`1TO zHz$X&h};Twja`xNwtk{h)$!WcK0na`)~8*@6-J1%2V7c`86wMY7RMu;@0<4cGc3F( zJag~Q^i(x@b-uiJt;HpyznLN*PcsDLK?P#R<x=+R*nLZVe>=oDwkuXLY%{fDp5htI~SIJ z06?Wpw|qyHkkzZy=wX{?o2;NQ`Bd||hQCDDrkvmbF$Wi?SZn}FI&9zoVSZus0CSRG$Yh{Zpw@w}DI^3v}GM4tfyq#TnO+!H(GJ(!b z-e^?YErVY6{jDfy6ggCQy%8GxdT;EtLkp-+_Beb7m;B zjdL97*Bg0O3%471wZO~_6O=I5dtkJ=%-QjJ&&-&D)mZLJ4nfPUJWlrPtBrAgCQ()o zc10o#O!evy|GPyj4mgpCfFC(iN;EH&E^IUKbFo?N6iEoyA(Cc@-#)*Xwk>q68I`e}Lc$a@U4E*6d2D!cTagEyqCP za?DP~Xk@dvLc?nij-Z4|*i=EYY^Z5+TpD7y2+2zT*-Yy!V@5 zSI9qIr+pGMk?v=iB|yGqO4;~eM66@HIQX91shCyaLKH@-3j z01X*^g#CZr5hFS*iWd_5EfAJE=Vk3DA8TdYB|eVu~h09>`pt~)D9S3Pp9n? z_SAH4^?`*E&s?eDe^#qAxXRt?Rb(mmYRP>TY4j)=&3(#ixW=+9x(WM(;d9)?l|P)J zb;HK(TX*qsE2NCjH2BB!&!+a=b{TzHso6mqS#O+)bQkdWB+I;K8tQkfS};mv1f6>HcFv)3u* z5xPm%VLUe)AUV-2}SuIT)HzfZIAUQRR0gsekXQ!6tYqy7nP*zq}Nhv9m3#BvlcPyPZ z5FH>HNx?7fh794mV{JRWEPy9VnH6U0dIu38+C`!P&tIxyi6F%B`twywcpFMs{mgb{TI_ppOpO|9bT_iiXXp7NsA{R z2{B|Rcd9-5epDVXx^3l6<=M6<35kfC{hEV%&I>zVbfr zox*a?1l*$l>2iqU^ajVU3&0EF*sD$VXzrw_V+S5Jg@bPAf&G@r6$K&{zf*}>j%)5u zLjSOkrAX#xKZVT1kBv0Ll`Y<4q2#T>=w zr`@xjWDY@Oo#*JjZP|V9QLdbA>GYV`;+71L;HlV19d~D6eZ4MI2t&xU=XUO+NaHg{ zm{;dDgCHS)kQtYg$fQuFf{bR+xY*>b=$U?Tc~`T@|3p929fava^KO0i+*Mlj$cS*g zu4CQ8OsK!7Q_wG7e!T?kKBJZ<(mE!x_u$95(%bIO((XP&2~h&7_>qE{^pwAWB$n}f zAV5(I?bMQ^5liI_3y)OusR<;cD^H-@lp_TCo)_}NXYT4|{xb*fzL9iSK1CVf1O%fz zVeS_KOZR@MDWTmej!3pXZETe&y*_exno}LGzE5ZSOu~H{i)Yldq$3|8;fKgO`GW5) zBY%l)aZLolz+A}hFxe=ei3G2+<&uI;5#|Si-^o*hBO}f32Bpe)skmH$#gH@fBm6Vr zRsS3~IVtaT5lN$9`iFi)o9F%@`JjCtM()mH>f-qDNFnR+sbSxiIuM#8Ax?B zQ5-M)vY0zoQHDgtnjchal~bhjBPNpCroXu&7yp1VU2=y+IB~V=`f<`l>4NCJ<$!U9 zKy^BUWDbZHN&LO?E@i};IUzZTQfJ@qj&EYq=Yz%s3PyT)5fy?od#{XX6@hFM;`~e)ybY=(qe)!W*tYoq6h|j9YK~C6Tb~y#Mnk6nAC} z`O9VU2TP!i6v4VJpiiR`gI#*O(Am$g(0H$#D)1JX;yunD zmeP-lV~sQ2)a1XjWG{unf8-yP?1-zq+OWJ;%b4~ALv*^Pq*q-h^TCo3-P&NF`yMLO=P({>Mr(2~-h&w+)84|9to1bNwR_67`NRE6m9Wq@IF$x>8ps0N4bYtv8>t zJIzyq*iHN0%lk5i*l^qfrPsahr69;kGBY&=Bq(4UHzE}%t^Em__q5jI8F!Gm?bMns ztpAvG-`EDM|-Gw0P9fw>`Br%Xupt&dsEi>8iQp zd#imaZnwOd&*O%yVvX`Q;%0ZtLTPD-la1wCKhdRRJY7~i?n>KSYw<8BH;@VvyFkIY zt1~9|`1XupV!6~d-BSR%!f791ABXBZ-l&`1Kh)!llx<~`#SH~d-Bnp6M;iVb`)xMH zq~(@9cnQxj#SBSEqEQl<;?O{)^XT``%F+HlCW=@5_;C|?KzZa(eJ+_8teC(TPISJO z3l9pmNE1K_cA)EIW89x9yXy}(I_i>Sh92MispZlG|9m%&(@R8bg$m(*j&DjveS;`8 ze>n{W)7Hn^6-MaSO@l(z@6spT45&gfd>oA3N>8sPIn4I&QGB^DTHhi$j5L9kHxd#x zS1w*NrI%*+De};H%8A6^_hN1gaoSdRF5`4AEQW;_FP6g=YZdz&bDQ5n`XmWZM2%?t^RL^4Kx^ zV{IB7h(Zdg{uhR4Tj1ZL+?y?q6XGH?7M}n5Q`IM;S@`n7QpdEGYpeavr+PhT0~yz2 z@UB5WfR}ka`jp;39P|Yo9hQjFZMsL7T(_B1FfD6s$E(pJ{dzIERpvFXZ~P-qGV_~E zGM7m7DN&BlZ?_6Ne2JDc&sh2+zf87Qxofp$6N>DWPP`;C-!ttBk7=y!^OT1s_DZeG z{ptE4Yu=?9PCL>Lz$0kX4b7%B zbV*%IznacIBKxFY6Z{X%>3LYWU4DtK0kgbFcXJ;t^;6y_G2A!Ptb`Xf&+*ypDsif5V09kQZ2p({d6lWi@?LrclzER!t5scBS!mpgc?~!Y}(YsYV5uZGSXeQ{`y6_%P#Jw$ax!sf1?65MeV-|Kb zk>s=wte=6s7naWCvZDuyCpC_KM{k&YyI60L%gorr0&&DszM)At$?9DAJZ5*W`+t1@ zONEPrRSfF>WZS^|@q~;?_Zbx}g;IgyDhBG=&$jxQ$+y+T~QQ1A&pDs2O z-LvCSc;BB8C*9xiefo7Ure=0`#KhHNQ+q z0P#P6Fd9&UBqn~;Y_x8iuL1M@=DR%hh-owTOtq{l1uZS}Km-_Cx3hzuymj0*!ya$G zXir8|@H-E=NxU?fzh@f(Q`-iV`G)iBNhhs>8sjS zHw(KKORDYXBP;h?%`r|Z#i7aP(!JQMHI}WS&PT4E%G+LT*K4`5CWXqmNzMturU%3! zK3JkFuPaa_*!OGx_yE;E|IX$~P<^nd2gvNQ%<`;#!-F21DXpGnnAGIac7l`cuJ5Fl zR{x4j*{z~hu~d+?XidTsAv0nyrEfm1H!{1`E8{%X%MttCESd|$WY{#;7GpDkj!)Be z`E_Yn^r=Z_@avgO$Y~3<$)j48!pNIQY!Hpxu2GgUNB7}Eo#D~%Z1%liEZXyyiWt0TyM|>u{eyzXvVS^hJsJIH9-;y7Hd^B!8lXz- zeer@#zLERJN}i0b-h^4d@=zh@i&vbZTw)AnwUaiKqgyRQRo=V=E91R*n3LVCk*wE& z<%)vcKL9>S_QN*QQ_@e2wGaM}(~yc$soHhb4)p$z_&loU){*mVL6IWLGQG$C3L*osM++}j-jJtoq>#B zOl08K?D#HmFPb~S>B}b5Y#Foc-H)TSR`C5HLrz7sVPZLZqQ>P~DJuhS4IQG3cf;)l zp~k+HGXKvjqu$NOU^_UucDPa=`~C=dQnCA*w4fOPU)9AmzR52z+n#K6IL7JTeqd*t zE^(KYQ~&}-h-{{Gm5DQVD%!JA_hI5U{7{zSP`zYF5q>pcO&bZ=S2@Ym&32>3gFhuF znG06{vH{YMCERFI@KH1s_#@9R7lu7Z2#ZVyJAM2W$FyxsYk#=6U&L!!_PBgusVcuz z6K$wrrxc!UDRNbZI;V~xe7{i8L(3&U$aqfd-Rg7W$MSziS4DV}F~YgSS9g5dAD@^Y zxA3{~OF8i^$V)dF=RV3JkM|M*m{%YPb zk*TLA*hH~$u{%oAo))dSg}r_7kPK_;qk#u=<5G3AuQmD^D-8c?S09>tc)hfQ9bwdr z<$E(5`rdK;84&&l_wv}x&V6(p&5DguXzB+mnv*kBs3J`w*7e7mz5d&r+)tPhNtq!a zN@OqUA3rSoDu$bC_Eui!4zo*y+kFGIWY7IB#C=xbYtG1r?z{c>QmDC&n54P=PxDA@ z_YYV+X`a_1w&FTLALlx45ZBY;quU+a=DB>@!e&;8Z@IdS&ScP{i5l&UeaU}-;OStR|ZLUn~aVtI=#8=s?IpEFM{D9CU?^e2);RdVSR@rF%pM^11BSe3h9rO zC*^LVzFhCoqw9Ogs4Cfu{AG4=XnL~gGEJSu^e9Xm9#2@1X6ToS&G<}b?V+eM+iSq@ z{k9V?T0o$wYPa1On(MzurRK%OxEoLH3&_jmMZ)09D{%5QuaPXXe0ZEk)4 zoH5n_tRr21;y1v1v*#Gg{VhYC2{BhbroHMDBl}g#c<0^i?a7|M zpd8K2D~p@!D=c27jd$Y(GU^JhqZpyi^MQeGfo zJQ^2F2WkcDJS!QY9BA&WII6%6>0uFZk$mP`$*b4YlGglTS}dDAJCi?ZQKDs@eP!SHboB%K~FdQ6{A=9gbP7blFZXHPq&x8L+cI(@~vK??zSK9VMf6E2s`mOo1M!wdom7i5o@8C_{ z6lSoEKL|7uS}hxBs?4n%SuTJzH~LPrmJb#~C2*?6VIttQ!dw=>KF$*Y&&U5*r$nWo zr$*gP&OkmrcAZ4>;+i@rSV-=+wdmHEus_!}ic%6mjdh8mD_G(SKp|2;zS^jlZApxZ zVnsh!=_>yShd)dDaXGquXg1z^gHJnJNCYcO%`kp*A%o{TZ90ZVvb) zP1g2O|1hCmiCFY{gkrE5c_tklv#|;pdt5MHZ{*@hljC4JSCV6{lES#C?S;hm(DAvx z7k%>cyrRdlBbt~?Aky-!z_Ul4;>tR1^1XIYoK$SmGyCi@H#Hq z=!U~O1}!a894an}7t%4Upa3!L0KXu?R!47E1nUMtifWkgEQZL=?7D5Biq3j|VhTJ( zk9O3%Hj;oIcY@0;f91>^nSh+K(ej#Uq%0ef^e-OlfG=X`gO^>${)jBU1$pv{;Dx0o z_&+j@({6`2Ax%}pao=L(>?7C_ST#+mVE0ER?2C(VO(DZYug^Utoc$lbp_#j6xC5fQ zVX%mR^yB1>f@9k_k}&Iyh}YByC=!bOvNl!NDNd)c>dhAx26PuY-SA;vRdnpgshU#e z-$|m~OP=sWB)B$*dT)RS<8T%1imZi-nm@69A7MKB-oS!8w05lRw#dysvGQEqiLqo4 zLi^=;%mBjP`aVim&h%P>vUmI=E#FcP^jVWvXIE**Ni8WqMq)kNxPL_I*T!Av5#vsD zS}HDPSyve3%>!eB4af*i!XHL-#6YO(=s}?H%M7uUdp8g_G`6DI60WYTKSAmpXiBR- zcWhtnA?nk#tRC}(IWxnGGSX$6zbf;g@&+6?9!fN2X`GYV3uznu>_I;qFxwLV#Q8j8 zEDtC6`|CBGO{mBV-0r1OF$cscT)g|%7{y727v@PqQ^Lo~J1oalG1+3575})qu`1+X z?rRrX=f@CM)3+_~w_xZ!b#Tb9v@c7NZw-SCxkZqZo9)>`hJS)pUAZSKB<#*PmZQ>p zXRbH%3}3Af-a8!#6m;%B=WM_y%M^g;(HLr7Y{~Cb>s3GEZI*`jPN~aa2q)PYS!o;> zo6q04_nd4z$eq~GUS=&-D+v+|RgqE>dy;)`u`ggp*mbg(w(+Zo|6wmp(;o)@W^x*P z0+u+BV1<2Vb~LMrt5Sc%X{}LZV#fBu1Qim1h6W+J8$v!?B;}#oV^MRf>9_YQ?R4Fy zwoqSQcO(fv{bXN>(WLIV@8eQvy~73P@Zew;%aoK!EEppZj&VBEOEvh^!w0|bsN$FpsO5!Ovn?^>2WS;dvmiN zk9cw%8r}b*c48To62y}++%PckuH4eRRIcgsM{RqA)gq#iTyIailoGINiCY@)G79<=7=w`>*8%2VIxi6B8Aa20%{Vjz% zP%XiSvTYw~NhO6^&bZcL!!7tc+qWpl375!#&uv{^X!iEDAZmVdbJ={V-sdOybstUP z_5L*UVwRe9*XG{1R0Ii<9(f^8DcHDAr{`W|{mE%kQRot`Aeu|9q*;*L0VpLBr+~Yj zIeb$N1FVF{#xOph+?>&x#EYBqG8^C5#;ucml{j$fzOkn>Qv#e~=35~sHN&8NiQ7Fq z*yzp5R$kt~Zwr}kiLT&!{Oa7u?uSk-l%uSVPq`bC*q_Ste-{ex3MI8hN%uAy73z+0b;=76sjn9}>uJgyy8}UGLnfXlm zD>r%kpTK$*!lyOu-{Cl&e^!OWD`w-+muA>-)S!k?u7gPA5n=-{qr?ti9_w_(ByMgV zhIVP1fV0}+(Ot}qJ-;w_BtIoxs~g(e(LAS#sYHCl3SEWYM#P3Y4{s@6WLSM#Ddbg; z=^oo8Ha#&3vHAIc1XX7lh`7BA7;D3qWQ7A5+|2;lwzPyiW3t*wU&B-?fBWt2znDPf z4+{DN@M4OMk@Dd^z;SsK2;_|&f5}SO*OAPLsu!mS1ve)RIOul`(vc(qx@N}W;RLCf zY0({z#Nc!5oOuAd4byYF)-hdEiz8mYdk5WiwJX}oC;)O^uiU|r)#0fs#Iz-`E4dTU zQF9}SFe5#_4A7g*<2~6Y!BqhrLWw!2pEc^}|Cpy+?=y`5Ht}?{3`?9P0bhtf9UCq)kK;U@djp%Q(>MW%R68-UB-d zl1n}qX^2?AxiWfQ%Q`r6e22N-70)fg!tmoI(Z}i zqQ8@O&3WCM6VZr~eH;rq$MArv1OGh7UL(V>c`}nMAGJ!C;>h4yP~(q&!?+FZ3n0lE zu%gt^4+WSmF>6Lh#tjha_BB%VKjG%q*wdQEhIKA$P6bJVZ{|^aSXN(ftywP>Ofp;- z7KYm+_xTJO4?^!t`gGNf_pja?{;<$EOjh`%lH0(CHB&kN>;y%*(C)A!ZirjFhE64q z88^RY)U&>5wArzv`q-hBUaJAh)3VMQbD<0}$fiW;r>Smp5_WK+OZyWLCFj83;!EMn zCRsVPH;kW;fJ0H#Jz`fgMyS_W7Ddf+bw$m!Jx=zXKx}jfI%?7|aCorG80CA9N8!AW zwi5!}_>R*WBa3p>@X?vUkdf`6A=!pHjU`kBpzwX*u^8TbpO>XMuJVa{WfEbpaPGbJ z<_~+`2U~AsyY!GzFhuw2g5?(c-50aahJH;fuYf1P5-(WKgFKA7%;II5h2BPb;)QqD z?qt|+uVF?fFVM*qc3Z>JP0DF;ol#a(ej)zBPGA%5xndgXVcHK3$3UFEX{{_Ch%fPB zHAPW>fI&URDSzHev8?ru!={R;{fgX^utY`vnPA1aK!6kx$UwUPQgpby-+`N6cc+VL zuc}HR)W=GY2ZM6r)biQYF%ax~e_lX@cCrgUNMCME);zy;($0rRehvDdKMp-b47DIY zjF>;*+(>;bG&=t#klTR7GrsBgt^tD!!T9jB$G>CbU_j_-UQS&c>gfIj2NSKgkK*Ba zho!k=vhvvRT!{GXYSZifr`k*ciPuarmgWcOD4NK->Quuc`sU_n4HJjm4?|&_KX@3H z$1A^4-TTsR3)a8)0R-G*(oY3z20W3leaGGUetu~Uj7;vOeEeAXiA>e+%gVDG0ohQ9 z!P*8=DJ9DsK)iogbjZKIRwDdilnf%I&o0aeRK-9rx95ZZon)`9Hf^oQdny<_4{N*=oB_?%zCv=-?+Y~5UcK0!jW@QBzIcA~Z z^wF85qS|WL9!6pv=+@3*vDKIS$yg>gyc{L|3-~4NUnOcB#xR@*7|wf zpwXPyoBWu%?LUt~{1Rq}NwpM6Damxqgg#!3r@d5)x2{6_cwxordvBHjH?>+zv1Q6< z3}{mVi-O##i{J{DQPo81*!IUZSO(5SA_=SY!VW%)|El{J@?B@ySc7mMN- zNKPx~VfV}3lm9ngz4P)EaSddc8lRG3STXrZe^>;;Bl;H#91>M}Tx8Q~rmRGeq@FF} z?#ZwVi2$Ob?aw|)7;;Z{9cOk&2X~22Q7{LfDcp5>L>%S)?^i}0N!hh!bjW+tUW0wz zzcbhp%W=szJ5XCeBfjAQZPi6!F`u;|q@vkczl;A;&{ahdXy;Th3Ez2PiGj$cMTQTT zYJK8`Bz~AGNPSH3SR%ij&cfV85F?)PFiOPP?#fJ3+^B25u534YezrZ>{W#mNAN(0N ziY_LVj6BD{sKYsmdhI;jGZ`g`4J>6k5WP=~5fYFL0U(5bVR^X;-Q~%b{c4l^3P&^* zCW~v7zl(AaNQPBQ7LP?NzluX4DE?T^RxscGldim|^2(}bPKNpBjy}Od{ek~#C);l@ zz9A=%U)H$zC=@&$_SA((z`xN{*J`REo`)doMVFKcEar@3@3_RSKjX}KT|1Fbbu+bE zH^?RmZKJ?u=8#DNofo2DoGD`UY^MinCKh?X$%bWK>iYv77R8xjtj*PYW!%f<>#e~p z*_1}3>YNj!@`dUQ+vAUx$NoEp0Z^5%iG1II{CLcy8xq~>*me}wL83EXoDzA?FD4AU z8&%3Yg8L}N<89xYAy}gE3A$~FmWly;&-cjK6D#J5U6G`O{CX9TBa_P_ywKM0R1aM5 z+LsKTLo7Ak({7pIwLyTfX(Ee{-D#oMkww$_84gDQjysI^YZ+7J>#Wp7Q4BKay!wF8 z3_(?NSGL;#r&%=X!Tum#53KT7!rZ|-w!Y}#%28yXYYR2QmDiv&@EqK30ECA{-Jz_+n5=iBpi@|k7@0e^JB#>XkNGx zfEQ$-Ki7Zb=Ss=~_OaqZr{kj^!%ETprj@43BX3M?W%)RkBX9|h8pX2e#xBFxVFK0d z{yJR9O;Ml1!$5iXCG^IMGCZRf3NPZKR8=8S%GS{OV-&%e5kr}8+ZWe>Fiz_QAzbYG z6bsz`4JG^az$^S+WxLgswlqIx?UAa~`m{IR2y#cs^Q+QGc{?Ak-efx?ossr#Sm&m~ zoM`vjU@4%`dJ0Y}tAjxqnZcqtsS`r5=RA8G_+hcRGFf$E7l(*+9?x*N0fmT-7qH<>)K=6DQk>2U}NIgZy$N3Y7|@wz4i`A9*Wuq zS2?j$$7-t!)DW53{^nWG(Cxgb{S}&3Dn_^UJ8!IjO-L(9TCQwC!bVgUToG#khAh$f z^|Wlx9+#>cunkDe8h_gYlO&%Jx=Z;DYDra<-`YmZH<-few%H4=_Y9ih_DA_L)%;x2 ziu;TQ{SC{Bgy{P)9>*O(r+K$5Pd*IXW_M~v5?oV0dmF(tS-S#Zm1j3uNmxx1C!25J z8*cqUno$ZHloVY1)w)gLb_s7Mm{i>EHw;_tfkTD~)&Rf`Xrh2QJAyHc+xcRFlU7Vg zS?&jm(|XhtNS2{H44>ttRtSpcrxW}ja+k25oP+uGK4Fn!M9-b3=eDcj-%5r>nf~64>D&U%=MB%l zWi;iQBvZhL;CvP|(>q)fP;(ci+wuzgTMfLEyYI@-w;m#dbhO?c!VmNUr4b5VOg1Xs zX(0<%bq2l;0E0d#q-$6oOm7tth2nX<12AF0vXAk}1l4;CJ->Geg*nrvlnx{%E1qg? z$;8$Af{Oi&;e=1*gF$zpu&L~+YJ#4}@)S=e4Jp&S0%Y_v0@N|F!vv3HLmID;1h@0B ztbvysebM^K+tfRSq1Jh~Z)1D_1X@qIgm70XEGb+VvtS~|4)qqz5HHJ$O254i^IZE+ z{Ua^z;!wD>QEQH&SW`l@Mu;dE)H}Z=y74k`xKrPF#JE9ZI8H|n8?iO5t&&RS)n0VW zlJg~YV1vnT9z;8n$kbjDyYfn5R*{Cb=v>5iZ__9LY3R;E$^vKbd zA@y-y;cufFwMPS>kqg1d#`%G?ibBPkj((5$FIod4q0n9lVrzd<1nd~zFX_N z?jO;#;CNc^k@HS7KadoBsC#JNG?B9 z5>`8(RDFM;P|G?Y{Bk2BREjaJMYZ~*?j4|bozL&b@{-`o zS6k>oFVu|#`N4oNR5~8no5?@&FC09r6!E+aAR`G25QXvo`PpV0x&HHEZQVUEP@Ur9 zn#tv@;)Z8<7zf!U*)LAh^(}T}pnW^K8HT#f+_t$Ajv3pup?!kTo?lg6H(@k&{n|Os zKlK;+8bFjE`LfFl|26*$s{Q4v4)@ul$U4T%CtR42R#+55&G9*TuCNNTib;1b4|^() z8t+%UdS|YHW>#YHD@Xsk#9l)tGhW&nx#yhKZZ@~RZbXZHgAp8!0@RMZo`|R+tAV7{ ze)NM@;Qd30`vk6c??*M)RsS4DBb)o-z5!#saQWxomqKsX4xi+~yKOFfw$TjjC)9;5L)xR}=oegs1Z6B= zhlm8X06?De*Ie#^LVJk^meu#S4}|UO5d2<)95VE=GNnL@js6qE5Xjb^YZwYVCh);D zAKGPRhe+|mXe5PF6%j##ObS?KE#orSI+yRP2H-W<-PE%qIPQHJmVNPF>v*nB6t^2F z1mgV(FMd2lVe$I7F}s<53wHgfA&%T+Q?akNAJR7FT)eP>vy;5&)I2!Wd_CM-6e(OX zrgI5E^XCx-BY<_phdCODfi#C#8t?VIsxik>lY~4J++k-(gZSI6`;|fQFun^Dx5uMU z&@hEd8lfCs$jVbTiKgC7--WxZHbLB4dz!}M+UI`XO}OZ0kxOGX_^o;Zb;vUDcsYuS z3<-sTXhd|lsHQk4SWB@nf{w0uwV)T8cZ_yBCM$8qB?%Ydwh3ZP(@vi+fND_a876Ln zVc_R`WF-<1xO}dT)s;(~er36;LPKEUIkXJ7;?YM_sV4mn5zNM)9#@am;Te4uq0#QSre|hA{0%sbReUYIPf$a#Fdwd<%Gt3hO zacc&9Cl&5)wTv)cvF@5O1Q5fU`mGn&eSYr0L<5!6)VCZ<<=I7aipBHPNk#D{AZxP~ zD4>k(-5Zva2whN-!5jX^Jf56J^bOyIMh|~6jQmXL;2ZR{y285a&kzFx@sM^5NjR$Y z_2S;k2>1TM@dN3GeSId@a#mT52gFBjZiM6JC)*8atDN1ID0mzGPj)&hn_{`Wat~i6 zuY02mA+J#55`Igoy;;FF?!MY=G`o%5Za7WzjN^M%s0viN=Wn5S(l#Yc00dv@5I+e} zC2tpAxD01r-R%zl{20Cnw&PEx>Vm=A21@yM!(D8OQT0uhRTmsrMtQ|JW=|MiePK$5 zc45h07CDY$qp#u2Wl_#1Z;0Qz>w81u%(3_*h2wE00HI-<0PakD)2He?h;T)3`l5nVqNYGXgp`{h@n{}c1=V1FdQ zALKX1G?oNwax@!vE}Zg^e;;@~0TX3&-N>QJS#a4@Flwu7E zFNnFu$3i^nh{7mjRUlE75X;zTB~;nsr~rhAN9wL`OWoFTyqr;-LiKZB3%`o-l}P^? zC}-hO)FJ0q@fztH|C)H=Ya&2KEcRUv2UkmFJ!8+Kr1^1cbRKt(H(^}@KFl5m37#Dm zX=vsfS7{XeO;O{<;m48bEn_;meF171_%8{b86p$ZKeL)68OK^vKDJ0jVD=DYJDg=9rDrLLiOpZ2Oqjd8|qs&Im zD!nyJa-6t$k;A}+K>gYN$bi@`9(ph-*jcKS?I{1QKZfkXOnc5r8WUz%b zR;pIVgOcDaF0}jW!fN=1LiK-2yjOz2E#wCtSO%LGALgR>j_G2)uA+fTv<&EhC7P34 zW+iCSSm10(w6J5YZ!X&qCT}k;)gh?|Q!eLKGY!^a5^-5!{-b=0a@)7Hs$n6k|uMtGeIGw;thvWZ# z5b?3mZj4ID)^7i3eYIRu<>b<$V}W`1l8=DiA_a?j`p2|n>a~;*qK7v?5n%BCta|6yt zuh_u*p2qPPxQjDm+yq`v*Hv0lS9dExbmCNyXRfZgKO~{%|1@Aon;RQNEyqm#b9YS- zLPH39;2EQgL87{ULrPKwZQ!iq0hIg*)B7omqd&H zs1)dJESM6qs8!e)Rs!e{db#kz?sgxN+jraCgLnZ=dOt1mzIras@S6vR4M_<&lXFo& zJ%a8RUR1`XHQSKtwvb#INpn^D+As9!8s0>sz)a59#(EWzlK?_Re#}H>1dbuFYE;`D z3BTg;da43}&#gP#{+^RU>4CI3ip66$doNW`?`uQv+@QFBTzR8?gX7HpjUaZSTb&tO%@q zMrsMcXA{LR4E>{qk*B5Aote$h1Ht*pi+dLG#V#m=I zyuu#on8KH-?!iIZ-V{ZzS;!gXoQ0a@6@7oJ#Pxqj*c!$hzT;Ebiy%nE;LwcnMIPt> z(7=w4+Qg|P=~JWgyuX`qRhAUie1#2N<1@ZF_;~ZR!+J@3m*4hfm8B1d?J|_XLrmSO zHRem0DrtjA+i_WDlue+PB=>tO)P!R*n6>O$MQH8Tca>;PK?>@ z*;ehc5cN5^R&tWH9Bf|}yv}k|Cl%whDMJ~joqN7AU(KHXRry`h{GM2RT7D8QB!*$N zeg;xZjw{^+a!CZd786nQa-;K+e23*rFzfaFi+I{jHPW!ab6!7f+?S$zpcFkopU~1! zM5oA@G0LN+{->WY)Fb)rDj?#m^c^*v=s8=xI6&FD!;z?w5=vExl!rg<)w@LUFW|`E zJ|WOrF#s7EG!(5&D9z9rok^m7QOoc>FN(O|WaY0`SnhsrI#34%{@6uHT=uK{D`lgR zM#|XO81n<`MaInUU@0_)vt%};a_KFX<0&a20Qbpkfw3!$J){whrm;)JTU8yt6lg*r z6$4?onj6zrc=U1?nU-!bkSUM~F}h|;4de-Ij!>!h zxgqs;H(%KzYCMd_#SL|eJf8;8CeY}!sgeg_Oj*|OZmVIslA zRrKpEXws}F2>npy2$)@D%vG?NRG1c)mDtZ?twVfAAcV&g4eyKC zsHMWpWe1;If$G(()j#2mHF*AYa6`3CNau``njr>~kVvV}HRN|InN}M{OjSiY4F2!4 zH@gb8=nLep1REu8Cos|641De<8L?NVp*VikKBS2*2kN+N(CALKTZ-@mF!>4oIJE=} zgLA@b!MVahwDxOY0X@#|uun;SH?%2g&-pV|=b;=>hpCm_M%oP%R^Y2*o6)laLgH=8 z$I2lm6s#z4gqsQqSUar`rI(NPz6Bvsxy0raU~#u-a;hp)8rusE(`1QmnyJV9 zuUnI-V$}Ud=U9JSNQQGA^=&{ySo!ef)e#GDG1|nCB21=Iow5rVA6>uV5ng0jyyx zxNC@=7QOa`v=o^f;a(Abc0GHE=j?sH`MSx#r}D=Un2aH!xe}FSPxuGpcOEEo#pmg% zG0Mf#h$g3FX@7)tIj_jc43jY8K{KO)?|S>kE~~0bjew7LG>j5o`ACQefs(47gI`{4 z?@wf3jdw+idy8?eOQBE)U`RH56t;D(UWX7oi>v{KWFpvp^p!I!(FZCKYrN@Fx`~yg zc>@Jl=etJ_XG7I5e+yV7>Ir;X{bmD6*)_5U2c?BOY*X^{$T}ic=`d?t@vyNB{vt_N zQjcE^sUkKp&LdXlkQ)_$g@vlhxjF-M;6`b1W>3V2AHu$F-$&Z*WJ+`l%Pz?Vlnpvz z;5H%;w8x9+T8)l+GLMTzimLQ%i@uhSoaTS0$fI(HzNkKh(j(NVz^08vfMXP_@y5B+ zui3PI6mW}ULELqd47!fdh7o(k^0xkMZ?K804?I? zH_lGPK8j37hO`H!#=Xu%%n32*Ky>(1EPs)R*4Ip&8DgSot2uBW8`V`7t91pA4W^6I zr>~D5n0`srWQ1YFt}RxRLC}0zcoB<@cP=(l_%rpd{nE{iQYZ=wvguEMo|(T|ZFfs| z9YjJuw2CnTf8JZO;ey}bU^#zvpeyox-i0{=5V~=g9Sv|}O*1_|ke|7?7m!pwNByY( zSi8|^T8Kp5L~Y=Yxwg3DDy*+x+0E7e*50mM$KbIr?zmS)081;oEYZND<-D9NU3{mN zg`Y&th!maV#hH19f%3*-gu%esXfN_8qJh8Pi+u6PtSd3A^8T?Rv-naMikvTRNhZ&E zI_JhTn+4kr6^TP_9jUv5QxyCjAg4hJ5>Ogv7dK?1)Te{#*BsQ^a6*#7YaVe&K(BWP zIs&UN85?WqEcP+MfatXVTPnz^LEKTnFhxK_O{=~O@D0b4~^X1h#S zWet7qY~GEyZ(P9AphUAuam7%T_~8n)v(bpy=)?a=flF_0KKq5o{`;F)cV^e;3I?Nh z$7Tb-hk8npIn#3G5v^xMI*|JX(|3VzQ)oj%TYfzqUhd!h+4>in3YSwz*EM(bMA4`7 z4zKBUV7pS{)q&f0a_O|LAC}*Hq|+joz2;Jq~c) z)=E8d=?Xx*stUxQ$b9Ey$WX;2(wW(1BCqY$$AeP6_m~k1J(+Rl@mMK2;93G{H$V+1 z;zG=854++vC%~EwZ?>buOfb4;`OaqRrQ2kpGDF35p|T{)90Y)`+3Jplho6M!*6Zb# zNDWhg1tWjLRiLM5UDugh0s+xGo~^$h91F}U#+|5h@ThGgWF$}PzjSR0;>Q#{|K`^t zzJZjggif6tZUmiz!mm_t| zbKYvV%`y7~=Lg~ZHZoqWMj(>lO}o(^g{V?<1}7T^3H0O-ie@B^@NZJHFNsK;=Lk5d z(E$Ch%LZQ&JT7~peHh%Kg>)B!OCq-Y&sYl&38K)tcoKbSUpRlvbHB&%kH15|IG!)z zp8yAqV)FPDaFyt7Bce6mM467^(szEcI!UL%xS7J$_V0g_`{pKKC^rb0m#B-62#*9p?29OKseq73zE{u`bgAQTFpHhzBT?YeLNo=ila zbz>a5FpEMsq8eQx^+jUjpvOBra59tzkYcJg&Z^qwwd9K+8byO6-YXZnUYA^=fF3>x z>Dl-_-a+XtNYr`$WcB0nrR}F&@1iH!!+r?Rx}})!@X(OS_5cGkjI=9T@!Gb=%v9I( zRyFOMMfDUWz~l?TkeeQlsT`Y!cXn?FRL*-|On_?uhN12SH8|aLN>eOSgd+)8Mzx0F zco;?19e;|CObK(*qVp{ib>nlbveSL|L_7`&+!_1SY6h#Zjt2%F_|RFo2;o#-NMS;a zLJ5sFFXEdorboJ@M6Kw3X>g1DtD$n~HKB=yP-XaN2DDzblMJ|QjGr^}wBzk2iK|yN zt1t%rODT+D2g>>`wxfe1<_7AhH#X=w25fCOs=JNqRR)+zIUC`*67U*PH@%=O?bhSf zpE&(rFNefxc(Gn8B*J=A*to`i5I(^F{rK!lhuue?*tC-F?Z}@b+}6wxfF@p-W`QH1 z%|fYNS0QS!-Q{?dZ0@ZvU7V=F+2L%dKW&<^N0?b3?O`*y2x`^Q8U>en(6Xs15i+p! zvAi9e$JG0{3TaBOxmIWti1^xecr!0{r__V`ji+tn()j5LrSfbf^=D_2d`1gNan{d$&xx zTFsNy(&BrQo@WS5xe$_8q-gBg({d*?x%KR(l47#5 zjIZlxtWFHeMG|=+*C-~qrnGW1Nx4F8D?Pljk8O+`^i~A$Y1nlc7SCa(OIVPv#n)5t z_JFWFwC?I`UX7Ko476LDR?rh7x|+znd=3Le)xy8IV{k|FtIfM9U$Ls$VF|TH#h2k@Z4bw5L1QT2fuqJia#yPK1@#?+eeM0RsFYW>dQy$jT<9Ec z`(5`ZT>Tz)c84SDPk~e`$YT;Wp0&cfTlW_NMtI*?)HcAID~+-IQyB`5fvd_#_|on7 za?*T1RS01@#MX)n%ftr;#q$)-qiC`x%NYY*9HcyhaxkY~i4nduC}F&Xg~yRn%=qxe z9-$hV9nUG}Dy{6xQ)%ku>4uh0#OsjjynCM9@JV!WZRL{d&f;m>6bx;4WcISTc%YG_`lQt)r@MQO9F!`;l}Xdt9s5&flJN9W~VQ?8#9-zq@ppa#muYXQCH& z>uoRkga!J9Msl0DCB7YJ59!xdrV*|DnNUIXcoT%=5goT92p*hgEq$PS1Lxsh?z=5` zDs2zs5cK59fw7l&jn+<;%L+{ccOA-S&dk{i@>HTKNjR)kWBh7?` z_qC$zqVqX&Z3i8tl~`Oer^+ur6l?l!2nlSiv?`6kohp6!kmo;H-b!-%7F?j;CxL9W zR_cs_+c@w|3J*O;J}AD7zHm#*;3a0D@PUcN7O5}*1?qRVDvU_V2c1&iY8jug*Ly{@ z_H$!-tJZ9`gm*B=ryg|R^j$YpV0cO7e2C3q7j%E$|Mgc3n6kE;cTIaNz_3Dvu~Bq6 zT)S8PpK>*(@+=5$Q1$Bg-@(4NNx9mI`BJn}XUzw0u~i(dg4lchPUbzI6EefJ5q@}O zRg06Q6|(fX=NiI}y`7&TR;aAyL{=mD-FgTTPFV8CAqvl{Z$DkAggTGIZAv<%pGUOn zx=YIF$}EpHYp3hz^t{NbQOh5X99$7a+^LGhO-%AMcZEvkO*hP5Kz6HYLs39<>gh9= zHMoakA1Lt0 z_q)qeQ4g0kB=feTx~1f!21RaAOYd$tW;PO^nTR4Xt*^)gJ_?SAe$YzHI_=-et^}uu$Em51UO}w)BCRaui3};nubsND1{q+wn2JX$u|Yc3)&kS3 z`oow|I{s1Ld#>gJ3=I=s6mt=7^sT0ntxs?3oIS&~niw_0Eg54=cO#GmTZkkZf=CKB zm3uSyFt(9s*l+At$%^APEpu7Jbb70%%9u6E*&7T=(t^uACahbKOqC1|DGPeo*k_hF zUvKTx(>Bvq-Pk!;EJIFLr@|9kz9}&qZCbae3V7n4EY7q5P+hidsHn1rh^2HICTO(^JdYzc1^qPl!ebgTp3pIq)Y zsr7^6auwZKH#fJd4hVc0k3mh`z_xkiYGzLP=Z>15@)A56aRGmE7+jwYD?t2(dXp6| zq$M}aAfMLKXs{lj2KXfYmScNg(X@vH)ohlLhpx@DM>@CL*qAvmQeF(663q`k58M;4 zn+G}DJ!rOz@rN8CQ7~y-$cQK+H?&58AA|;#m;EEFlOXl4E!?*&`)04cAss5H4@IY5L}o6=ukCAHvckjHlP+NYr}8_NK{h zgmYtuK-V+T+s~dqt*;fpb30GOkayIrl-;3?vSRzd2a-xJI_yn+k&d~55opp~Oq445u5mZ=@e8PH1# z#ku9@k%l4}HuIWOccG8x>>?_=WM2*>^`%Nk%d|(sR&qmEQVV)e z!2s|t-KP{$Bng-V3wnQT@u)jId=!UMsWN*K$2UjIB9Jt!fKKv9x+8*IF5JFzFk1w_vLJ?c+hb^o z&7-d!eB220F>1LeB@j@?H!oFk1Jv_qxJvjC(HWoV#>BF&+KtFwU~ZidT<8Dgm%% zD7V!;=#+oTzo4{qx*exL5pqS6_VS0um9D#j>Z+weBw9yhxy0Vv3d7uMA;RqsQP}=U z(S?^=xboKf!*SnUW zQrfV-v_Jutgpp7?+Oey;&>u+c2?yfNtb2I2 zbj7+n7SrROFIsD#c6y{35K_ssY7auSr`Xl^f^*Q?=hflhZuU0F%%aS7#DOYv&Z<`} zgU#)&f=bBR4j3Btld`I}Kpi5L>A3HckuHcwOJp2np4W<3cU3}<%)pPY4Xrlo#KLA& zub<3cMEy8rB^6+L<=eUe67V>Ef1i-LN@f&D%>xgId@iU)nl@JnA`9ifBhtkCacX4C zybJ#Ys8MCnLCLFJx?b?9PT5X3>C6%#A6K16ON$y3;qJg5(UmLGKz zOz}7Q@BQI9b|*uA`eO*?K{~lime#KoLXI2ODFko!Z(edArk~#7RN6O`C_L%>eRjW1m&Vf8Og6M;uvwYYb--h~Gp1{41x+&5ulh=1 z=%{G=E-z~@*0`~cB=e=SMS+q8j_y38V;OpN6%n!KNCS8Ia$E(CqRM8l^ z7KArj9L4~2G=Os5Xxr=jA3>j9#O$EpKjyf4-!JSrO0Ts|=gC@b?jwcZvjFCbJwTsp zEbu(cB!+qjbPB>Df}N3NYyi8pilC2@9b_BLbi9FlIot;M-DcGkB%^H&>U}fsHnx_xC&`05%t5G~=Ge0(Ix?4g&jo_o&#G$S*$lmglUmy@ z;*^%#uea~8Hk?HbINU^rzwvLJh&u$~2|qn{ZAN;WmogO}+XUqWkBm(x8_MAGKH#Z+(asV^v&!?brx z?W_n@JM@1HAzv!+U8N3HW_&&5o>gUoL3>d&0Xj8%ToJe$I1m zBT(hSmuS!2CbtGyg!YJa+Z&w-sbFhxeZ*1eT>W&!8R1CWmfJ5s6zq^AA*J$o$PIsJ zJ|}z40$kO-c!^Plj}4fCG4`5$&ApGa@NL$b9-*hkqf={psWGu6?CdB&X}O)`C(t|1 z=)m8~XWh(ypX6mFhxL13Cz6_Um5Y(S1TlFUk{AjobnCEp{Op1l^zGM51ywPm#{q^G zl|?569+zBsqSdUTKM+{HXIoMjlXjakw-m>Jx0zv6=6(7BPpL_62{_5u^JZw&^;D5x z*i7V#LXIFu4(C*explUFy(S-ksG;DU7tturEg~&Wwp^yNG8H@1-WawMCDvDSF->Mk z5l$H8i%T@RM~nqj%o(%ZO!SfGjqGsS-bpn8Q67sra@47?5HdyV9 z?Mpl+K7W#Qo|kkYIB;F^5v;NR`vh5_Uyol&Gj#^&eHP2M1Kyh4@-)Dv*%;6kQqiR1 z=u%YT@+f^lWIvTG345Lj-&4~}mODpLxrh_%J5UiQ#ugy+s0Mrz?-qTIJ63GYdAZ~N z26AViQ1<$c+j;`LO2+_|1y0heRL!;}C< zNPonh>CprhEap1#4QA>s^NNaof8)V9#u1fPh z5XJQIMdGBjHb!HGYbp>#e=Kjm%TsEoB6vrFU*Y%gcsZJDAR0*9s$%jNSO8@>-u5hi1I?}^~ML!>%-UqMnb?)GrZghDycS%k6< zYt`HF|HnlB-ZER1hJo(btwA1KY7}Vp-TypvF zLL@fA7X`M9@H@G=a_G6KK(t)Yk*P?ZoA;DNMDF)`-RamsehApxTf(+1^g5mJ<5AaG z0Ji5F+^=VKyaAn=2P-Z#oUa9VsPpW z5c#C%9ioJIhtHxSt^1r;y1mwd=Z`(#*!t!*EeTwXo)e9|oAVBRtgY*HiJglA7K#2k zQ6}tNbZfOKd@FS#iTpG*n{TN+1#NO?@S*<3_S53QtmNngejd_z2QzKaxdGC$Yx=#M zYP&*g>;;WOxA?YJyPs!>e*g{thNk_xah330Ud;Yk9{LdqNwRuUR=dbVFhW%kC*GW} zr7khUm8mBlfY!HJeh8zy%%cFulCS%2RQT3&u8*awSx}y3BM^%eINicpRLM~yTBi%f zM1MeN{aA>yFHbrd_YlMe*m&Bx+6N^qa`S~vvb3&Fw@a6@k4i9PUEXq+)0_^Q|L}n7 zrE999t%<0W#8}4QP8PAxPxrv%Uz z&5^JdcSI?KOGQn3JlZX_)EDTM0q7|YZkv4DI=2G7FZdSI121{MI23>I^(PcU?aYiS z<+MDstO`h#ZyT}H_k`_IX){rU}hEiBStqO9? zy|S5FcmtxIU}b95lwnEb-6p;093NpfG90&zDgU{=Kv;eIGSKwPd6HplsTu|6=%qtd z)$2+-M$S^Hom(wH2oG59CV^xCiCPS#Mxme&^7bOQ7F29lGCR$)p(d2!4M>+KGS!s| z-?i>K++zF{q)Ox4C6xi1Bas6l-6aUFgakqBU6Ohvwd-ck)IXgAv=3>2z+0_?J(RO( zOUjOep%r@=cyfigl#pH39&x=9#7G+Cn=!w2Pvo)lYQ{|3pq=g+bET&5^eJGI6)Rtt zNMEV&)&{XDtz0y@5j7eJ zd-ANeV3R~xPdUAlyexD&1O$=4D4!hv;;pgQEe&|GO}Jvxs-Mgh4J<_JEavhHAG-#&g!k&$!C9|WrXpXU6fkAIuGsK>BQKQL0-fBoU2O=dGP1D##bJ3)aNXP+5S@Ys_*d0$6@Kcn*utA zZ#BTg^5-U{euo&S6UpUt z4!5&YkY$MC8cX|?=X6s)o>k=K@ibjjv21%|YW<3PwR!5}Ef~9hpIyprB6b)IKWLYO z#RHv7Hby}lyOp3_f6bFP$@(M3dyt5=^@I&8cs9bbebq)t4Ouu9aqcS;7X-+sjBnq& z$C4`V7>Wj?{v+M%Mtx^Qo6QKCADC%tnhU9?$hG~dj-y0|RGMR}g~7;OlULIz<49;( zrp$S&A7;!My}h`lBkTy%eR?sMFZX4H`D}rV?4XKC%qULq+%p9)O{Yw<1B`=|9lp!B zgS_lJ-75r0(IELzWMcR;ShHOx;Oo8o^6$W{ch%4gt}0-gqWiD92BC0iXQOQ=kVp+A zXjgX9apHyB@3L7vpt7jMj)Ur?%s#DR1DSO)rdU28BLX^c$N!Bf>-Df|V zS*@lG0V+gWZn_e}lyJ@YgD5PEcVnQ8B83%SPCCCbA=LNH)Zx09Iwz1Ct3(7vR07{8 zTA42M1tO^BR$%p`b@mOw?MkjJ{W^Xk0T}uvb7^N)^%mdt!4k1kgW?a zaY#ZPODT`Mfgbce>Ko*f_3h&=nPO=}H0pkN@e#FM=#JYTi-FrPhdgLz8Iqx8_12_c zq}`FKC+Ktz@4XSiTae8>sTKAla2^3o6;yM%@DPhFX<2MKMO?*goeLIA+enHLz*mHM z3uwp(LS>T@N?)`d-~2S5*Z<;Bzy}|eGrU3Yos;jeY~ZVsBEnpButyWyJ$HR+%lF{~ zz^akhNgpKTyHlHKiCSRv%ewmD9Pa9FKLQ?O_>+~nLOiMHSpJnSb=FCI|2yStKGiMt ztm6+ex5@qIJnjAfKxGA38%%@v+#|IB`E$~Dg9{_IxdHU^}RA>UU|OFo|;2%RZ( z1rSB(%-Z*6RAbgc1waLW$SjxST=C~Pj+15y0-(}cEj3L=rx7f}?-H#U6=wDf`JI=I zho?Thj7>oRaZ6?^bw-q%r$<+VgvF4F@LkjvC}9UhGmePrE~e=p{#haDe}G;pme5Dy zE7=~Sn%bQa3lloTc+YOgH&%78(hc z0v+?Pdh*f$!4u*cU3LZ>G!rx()nxJsZ_4EAp?OGr`-E4Gzyy{@reLr3p1P zvwnUs!5uZ|E9eD3(#aS_|5@ z?SAJZ&|Oj3h2W{=ZhA+;W|HIFCR6Le*BOJbKt@94=jVeMf{4bEpBo5#dq#38uj46n&@C=qsE56vrq1@1qelsJ(}SheoN*g(rkUuALEM zE6qmiO5&thK11J>6bv)1Jx7yriuBB`dmeVr&W;R@-#=-c&R*}kob~o{QqtluDs-IJ zR@9qGI%}gKysB`Xw zo})RvSKU`bnC|z88VlsWFJkfYueC#|nzi|IMIbOR!FI3HtC@{& zOkE`LVNZ8^<(8z=E!)OTdU`%{l2!QIV3dR>0!R_5MVYfQCv${HNR}-U`G=5e`Asyb zj{D(|MP~3xe5hc4;rUn>9SkP1picpL3RQ=nw_z~~dcW$4@F0pDS;oC(K`d8SqdA)C zSCboFwMa5l&xVsHQ9?Zo{gU@d@Z?%|?-p4FZC^zv7{Ss*wt9t4`N|XR?D`7Ep6F-u zX)Zkx9HfT7JotC(WFm($n8fo5doyMjrnmgZHU-|*zg0ikr6RfedJsz zCr!dG(lB-uYPgCad;3~tC5#NQbBX|d>)7U7!kXlP+BWMcKYq{sRT(VnkwD6&K-^J zu=iocqaG069`=ktI5$*0GI0U0i9=RytxI zFV8F1T=Uk2!=W&0ma#{9lSYQ`WH?j`Dk@^}p+v=l_GR~%qXIOUU~D>-L`a;V&fNiQgJK0(3cD`((Xgs}jU z;3^MPu@rl6-9YN^C7A^nya-KY4CmM~xwJ>V|JvBOujh+Ra2JBCU-BZCpTTWj9m*?E zAP*-FR~zQy!4Fxl#up8%q{J3Oc9dorow5yP(1h9R+R}hacnAqm z*@jhz|8lDjO%WhAAVq(m0IsGo^5T7PVcSczTFB|G`NY7I+v2`U*3&TNMLza%=RI*> zP+5$HQZpUI`>~Zu_uM9TpHHiIjad`Eq=)1TwN{yIHllQui1i)~58%TAVLRW%&om`Y^8D#C_z%BA^A?J>fG36vILL6c z^GSYOrnIF`>e{>H$_OKAd)fi3)Tb)4_54m*cf+~D#a0!O1Ukk7Ro_YsG8L6g>O)5h z=EVhb9>`@-45zXAx+M~Cs>2g^W&!D+oEeHslg+#~+^WP$;LJ%QTbZLkO>OI7A(W z^Lz9UIRt^EUZ5+E8LVpXr~v76*$(B5`Er^6QaZnF8RS0xLaG_+y6{^5>A4hJ*m=VB z)cVzun9H)^CWhP}N`-&gXZ(KL0`=Q(XmBApA3T}N^(iI)@j2ltSSzX51`uqPGfII@ zY3%`(gnL!(E5NGv!P^T8-U5O;&d+5mLw>(ruZ{u!=@@mm@4MRG-%xjZ$=OQH}_SH|IiKyIFId#Y)nmU zRQ8{BG>Tv##228eyK*8Vx1f;E!5<+c*Bpz6!;xZ|SDxAv&Nco(jvrrgr2 zZGJUL`A<>sj3TN>R9{9-Vf}et{@9}ZZ=!!=2Nm`R&A}d3$XM~8R6(A+6~OFg7FFmlZ#mYhYO>n=n z@!u$=gryJpWit30g=)Xc_is@v%t;9m&dfTM6wcoq>9@yJ@PFwQW0g|*pKM}~QomAt zkoINrKcLhz={}*xGta~yQ2qs3{o5OUF&+RliSVb-wxNjgRu}Znq2ogakl#qXgd!SJ zLR2oohW=}L2*1XPT-cX}W|%?#Lp~Xd(B|ehRl)tvzot#NmWI+uqqbdaQusg3Vk9BF z6wRN+)xk;?nV2Z&+EIV|9TBJXl##QD#PU$6?>{Wim0kHS3lcY)ZZ;Pej+ z;BNVBJrWQ7MDpE=eE|Uq6275={S(g+8voEn1u&A-geUE|8n&7XcCCBk=HO$hnrA;`V3YGPrcOpu z$wD*eMX65nhuS>gvu;cp^PPF|KyH-DpEUfh-uoN-q>{fR7#h-O*h5Uq%-zehV>@4H zGD1Av;$~#A*2bw(I@@4u?2lPM4_$4-l%dmnGx>qWscbd?YN_rx>qB%N9ixDUGk%v( z(E+7B>F+H5w;>UIae^U+6Jys{Z@u&Za=)h}QMkUlyqx5?;$&2yT5N(88!u8w9ht5t zg+jorj910h^4{OQu(*YI#xX0!lv9LR_CIUHpET;%1h;$qI??ZbP5RDJSVhcd(~t(z zggvs(YT>w#)$N0;n*+H3RcLlDHCt(tt?>rOHE@<|RAU))O=XHo7D$9ySLE4(99Ly9O zE%u#)rXVf7=`bm4TNShK^NxEd4(Dw0T3YnIR+^ktk{i4Q(TC{rQ^fE?zVcN4$dg?% zJDk;lRLdiaz3_>!t`BS$dH+6BI;_I&5`Ct(H|$Uu(iU8WM8!DwaU%$cgv&}X3MZU& zAU}!I0h2cq>H1_Pb#iLT@TAdxhnSw;9{bV=KPAoJa`(8#Zj0-k=Ply7o6G)qz+#;> zQSCDXSZ5A80n@suto1TBpvMglJ02`l7q>C3ihLqLMhWRKZ#Gm_QTcehR1YXQm@dp! z`!Q#_H`=OSOUCcAsZKPV^Fj1r36#^YS9E-Id1p3LR9j;@=G`-BQHwpdQf*3LvD)$t z@bS59-;E8U?c~t_kjpxQL9E$7#*(Awt?||QB;U`EYQ~g=(?Zzm-cfCiyUKI>G?foD zKAGE|1tbTAF4mZ5mKm=!)l!G_K8`#Ru;_k3K;M3;Bk9{DuUTj1_fGS*<6}bXp!CbX zGlLKdhcw+mwDgzHh%Oseww|v@gCwZ*urUC6{e0g1(r*$QPZ2)nqgg=V>D?tk@oDww zyHtq?@**1}<8yf-CRJ%uz~|=;jQE44P!uS2bkDONuW~uaxU4A61E8#6&jx6eRVK&< z-c9sT$SV$-ZMCtR4Cg}DhAA=^Z5bk>pEaKbr0>tV2D+tfWC10VNrGO?sdf@V@17qw zx{rf#1?PTF0W(h9l5G~_hnUpQP-GL?l*#<@_M+IV7cmC)eGdbVp9g3Jw!=5Jpz&Fv_PcxF)kOSTvw2hP(m2!66nXFiC~t^G zXso6bQgR5qz7xOZe=c5GC?~l0-v545oFI(jTG=SGCq%8Fj`+d9&TBB{bU&D3RE@vJ zDQXReMlPGe`>o{Iy5I<7UnnoliCwL`_pQN8FYq;JALFxi?9)g9p{Km#(L6wp2IcSD zwipg1{4jfir`ff7!)R`f9z7Y2H^9yEPHKe$7^u@5rsr^mf-pyFzW%PxG&{n8&m}>Ekybw4E zpIJLE6g~izD5K?&SF_^@>;`F~K!pdjKBKml-+a=k+yvR4cE$ z_^elJk*Z`-?fbq|v#}c}`OMG5y__b|pFCS9rl-`*XEmJl*&a7HCm0Ay_t#_*rD1yOn%cq`{{mNEn zOaK&D6w-PUh)(7sg>*fzV_yu0Omcqcdp0(iKI`BwOX%Qyt_}48r1r@aGCx93zAtK4WJ?wpj4XQ7h^{@o39YO zKA6FKn9H(Wa-KMtA=#gjZ&&hSwHG?(rZAe!F+aFnrf7CFFArs^vso(*AB*Ci=h+G% z=`FHe^uGA5!0UhYhX3^ci4eDu;HI)q;E`anfPF=|S8*$0FlGuMtd765uGh)#+_hYi z=gp<@y4yib;^Eh2yfxubFBM^eYPONy(Lvi4|B14-;b@IEGsMwY{ zT@R#~>J=4@r!L*~bkB=erF~0-UEa+fBiwq06zM}@q;3I9CJx>HHtngh;QMP1BHA-v zhd~&8L3oC1&J8nIQgYzqt$ge`r1{gwq>E5siZT%X4w^;I!WBDfs6W>O&r0+Y|U&SloO?zP~vdAGObXBR*c zMbM@)lj^c+n>%lM>LS~AXA;MDw$6b}%DY}tJvz=+c*@dtD*>55J9tTR$Sw2z4LX^o z^4{q2{(|Y6iXvvhS7-7a0r_xg1^g)@_T54=)ZWXLHm~?#kslIJ{s=!1sD^Bs|#j0OW!pYC?_LRS&ku;E!pauQS&R5xw265hC z_v9P>o!u1|J$WGbaO6$)i_-A|MSrKBLr9yH+L@Tx*bk7lKnm>|jTCex4aPRk_&10V zG$o;&#BjE}H&-U*S65dRYJ7n%d)gq0jWucsSb;%a`;Ih$hp^;WR+##1;~|q@FU6z? zRK~2R$V!@G?8atx>A@p_ql(|sU>Vtu)cuOByqZxTDB75na;IpP@CfY4O$+8zQ1oj|9Oe$ z=opJa@RFcc=fsQ9hfDjpvPyxXg|iGud{e|z@7ua#gcP_p_i3$--&)b@bjd}*tJ>6^ z-+VkHEjX@Yi8scRaf1zwcsi{1L**2gt-IeKwxD;byOSZn<`d?aXet^C$JkxJvqegS zy^&57f)NY~KKhKFA{~ozDTX~POtXNqK2~6t92sAos%$8S-#C@2E$$bHg?IC#g{MuF z=^Q=v@|nTY%fvqwP4bEXI(v!a1>GnF9?w=315l!jck2Ic)W;Kr)IEEf+Ak)}3qqiH zw4u}TPliW3kcro3dzY8>T^X%Jy)sGtz31(jBJD?q7@Btsk`4}**bK264JnE|hA$Y- z7HEC5VQdMVWNSE}e+5xaW{1@63zvLpX2Dvc&*VR$%8$FOXTCr({5sPXlb}=ZTH)Zn zF6I^3$YFFmoXl5BM)>J7s+8+KauF+|5JuQ63*imr+HLm3CB@7F!c;%;-8EHL#Pj6` ztjjY_Q1RG)g1zZAEq}g{Ha`ySgWS^3mi~w#%sn2n-o%Aw)O6F`1-l&0kA&PiUsLy{ z&z5TKW3fuz2G`DgHi*qYxR9tHP(%5O=z}8(TS4U?O2G$?W51x+ifo3+o6jj*(#) zr$tGnA0C5xg|8nK@+2N6rowu<%Sf8njo{9zOe0#_50AVOPD>M^J*sNc+2MIQD86GA z@3}Vov**in1Zx){M}fF2Q`W)BwJ17o2flAMBgv3~u(MNoQyETBI8+gXBn;fjdp*^H zflYhIkF=)w-@AP7F$o$dT-RCi(+@ z=CjTfJSoUyylf(YoAsyEx3c}^8(gFTL0u}V=z7GAR7S+ zQTPS)uYXd$_+Nh(SVHr_m%yLPFyFl&XgwQAvQ|0XEDYCpo@;;Ff&@AS%@D8P=D}^d z4sdS2*Rp9f0#&bhoYF=Ip2V!i3p(!WJD`qZouc4-ZptH=ZN=y|*hXEO_eZ`jK7Uo4 zU6j36-8{}vi(US);FaFm&`!=v$?r*Dq|u2u3$^Cn*(1^(+x$GWZ_`s9YIgj&EysUu z#usZinL{TBjCYj%(c(st9PL92r|W9a!nYN=RSbssEa)iFODylRY=2X_Xw>I45#f;HgGPDd*=YCar*#OZzvxpk-y^qpp2E z>$$ShWFcUtR*UP0Sa7I4?^m&WA1g23G8H_*Csza2O_kY32g&?&0nl>K;B@^&cDl2? z;9UzZBLDTYdj0cLbN>CSznGza<&5%$FSPHVX+43XROxG948a5g{JMoa;3yrXrE`Cz zb#W`ZPCh(s%hjZ%v-ZR7IS!+cquI3YzZW^RE#a%&+&(BLvs42)e2k4 zk!$D6GK}tfvXs=@JR9va8!D>ga+?l|Jc~=+lM55s_f*W;2J4rr)a2yD8Icv!a7@^y z^1il{BvQ#RYu3z%k@2m1JEn@*VGdD8kp6TBt#*n*Hj^xXml*#`+y0#wD8yH=wx|XE zdS4-nh9*P0cT?(32j z&I!Q#dIqU%l3gz0?E?5JzuiITVS&PG!b1l{chVcLL&m;_>0cHxZyN4Acr;}g&CPTI92 zm4!?6J|HZO?-452oAxz1C|WENWJhg}n(Opu{!iaiofk)c?%zOqogJ|c*P2&Zg}KD? zAPlDo%&j<1t<3g7!PH$zcDiWpt>7h_jC76=YB~ZBOI=1LHmk=3_4cew3xCLRnIGS* zxTqCB^;65oG6olygVvrCrVN`%g*Pkj7H$p>c%6F0^X15nkVAn_m-yU9y+>Bu%YhW5 z_G&s#Ap=f5J?lUG?d`$3y*Suqjk{csHL{cM^rMrSuA4(0ZTza^l&p6B=hV`pS*=qB zJGn@hucV4^WRncv@tritmI)I54Y_0pQ1 z8f3YxkMrcyf9iVQq0ME9qcn@^G*=WOH^~Wy6b;3Foq{`fAcnfGHR`)L31yeFjo0&T z^*FBmcJf{3>8Qr2MK)R1OK;8LJhAE5y27(jP(*GMW^5lmZ_~cAT%c%Vh4oMlY+bcN zBOIUeI`!x)uUv7`IX~;duxC&!vyTvZDtYJ=`g|j~0jhwrO?^7MSyEm$P4_a9JxF+T zO##+nI9;dMUyZxm=L_i=@w2pEA?KgUuhn`-?5t-|Kke|__7e3ytnJ8FtvDuI&(3;* zn){lBp3aGZBHbbsde-64lXI~+kQRY8YY{BKJAIeERE*t&-cWBf=H?>{KGyX;q37t@ z(o=`?P5I-~4oHU3Fr5Ujy~%N-+owN_@IS5Qzvcusf7`eY>d|hB4 z;!SucTYVxpdU%=_0W?H*kcO^B=XuZSRT*EG_EKQm3X@}Idj|`)Md)0M` z6n1j}%3fjK`@vTZ9n~J1mH=|9dL$=soeX#egYuL8eNtezVXH^Dz$rip%9BJptH%N?sT^O6Mv$+xg!${VdwUIX$`k$Hu7WZW(`++hTNf^@iMqn^ zC!1EyFBdk|y8n*Y+sW@h&vnCQm{otfAG{KT^-v~v{cZ}ppMCdvcbK>CMcdsjnKmSo z>#*dwcRErI(e)XOaZHS4S5(ulyEc}ya_6u+>=1&_R2j|e=;c!;QD7dK9Uw<+wosLO zxKO=hp$DwATCmSwD~u4*U0Rtba(*;O~U5uc8R~Z<#MFH%4;eL$uUUtI(dSb zjio#KhbQlNM>YPlvVJb=_3&SLc3-rR7c}tG=b)7;W0a+zEqNp16hc2zpdAssL>nYB zCLQ`W44hKQ=@&H9hj!j7o(%c~+zi`8tCLCkY(5<#LxD@o%_aV> zlK(-H=`WHl34|~IL)`eU1VN&b#aBK?!q$^LTz{9Ov|l8R>Ae{FyIfmDL%6Q}K(O?8 zNpgP!A?g23#Qz~Kh`#>6iTFQc^vg*9pGEw;&HvR}^8e4JX}p9h%&2)6HqHG2uHLXm zdM;a1ZLVA|UAw2~6K{`1Od=nM`d8?$6%mNO^2567!=c2qM-%d2G5DKP_)QoY=a`WA zKIzor@fPXxX7>PIZ4!t1=3@QYuyx!2$JkegMb&kEi=YSyC`c#*1~4?D(y1s&4c*-h z(w&NkNREKyP}1EEQbTvwNH;^r48wef`+n|tzwf)=$LsPR{AbSDXYak%`o&uA5PRdjg!(*376 zmCbS(ui=}QDb`c>eS8 zN`dsab2$468_cia`JVj9RY^_iC#a})L_Nd>TX&{zcbVanX@%)a+q&k zFbqeI-*rKYp6(_k6>?2Rw0yeQrW!u&E&E?`n!lgLN+M-rS|!VcZm>v?wrT`CqoE4A zwQlUUI9R!pxi!ipda`mmWdtvt2VM*&m>h&QoVkYlR(SW9y2^P-;vxE8~zvAKL} zsL7YsGi*Q@)f-B68eh=>R5y-GXh9D0NpL@v+L$K#Cr$P4tm_PHi%fJWaRD{n@H$Le~_3GKHz+J>;z zA_Mp4cT0N;9m>oGdUDl0dcT(d$1ZFyq$?r1Q~8<4(a7$+rvx9{JnWgvwwv^BBMNK_ z6dfaG0xRE&3L=e~n=sx`&(%1J^z)ahGqun4d)PdGm~bkLl}WD!gOXiO=Xj>s^cn?K zC5`xO65SSuY_|%kq>6jyP9>%`3ra(wGOVtRsNFJf zMQ*@L5s%2|g3r+FZMb|P+OBidyT=po=Q#%sw+91!x0S+abaW;Pf1YPd#w3!o6>F54 z0+qIpJS)TRB)Qhjz;RQT&}($bwDQ+A_|@EEc*y^}N!7GG9Uv^5y1?XDb)OH&$86>p z1LW-<68<$V0nMR2^E+2~oz(Qu;)&3ypyA52O%e4)5`P5`?gzkIK4XjgAuUZYFMV4@ z;i`~48@V-K*6zDgYByb;Gh*uz?R_-l?;rJQ z4kE_#>frvE)Gh{@@7smdi{hs{cD{4Qr4>`AHi=*y`N7w9g&)>uYtn&otuA^)OyIO^ z;baCOmvr6fAONg5h)4Lstlt?RK%=gJzq*Tqt-1SViN6+uNv4pT-XpT78DOkhnkUKJ zochf%m&PBsZ5LYP5+C9b@h$tQ(^E7ZNb!am&e))`oE`Cvf8!$cCyWvGiFW+ZE?F=^{kFaHHRuexGh12{ z`lN2Rj|cQ4WO;a~G2z>s>7R^SP_UQRq_IfdOWZ*a4K}B$J!F1~&>%vWaa z_erR!f&Q-jkXis6aiH~j)(ZCKMXrl&;|Bn{VY1C3Dx$2#C|qcXTCQ8*rq@B2VcqI0 zvgPVme}&`!Z}j=ANRFTfqEL)DnFY0k@5vM}kz!$69jOH7>!9VLC3ntKE;L$L2=aZr zb}wbsdHdq7#Mk#l4ctTILjd6Y!6{PPfo-zq{_Btt30iOSskb(4@dMvEXIxJ6`r~of zOeq9zboOK6ZX19|dgERUkWZ+=PI}`UWg4`q*iG^*Trra+MYT*y!o_Bzi`G^_U zJ28e?*P^W^Fr2W5t3JnhP3L)ZRlaQBTL! zhQT@1)FdwTJT}5--%=zQ30$hdDxK5-x?qBuu^OF)9*f~0~M-lvTo;RwjN3g)S;Kpsj0N#aR&C06EF;;FQ+%2YvRCxCY$+a zVSIG_5vjF=DC&Vbh30Xtm=9|GI*;uHqwbNjo=PtgL|Rwo%7hHUcMrQ_`aD zJg-b4+H1NzE(iOa3OY8lj|ZXOkH?>sqPPxkvZIfT-Wv6*+x3_fxLLnIByy258n*zE zBma@b^*&TI`qth5o+apipa)(vZ+~p-9oj);I;n9fY^KJspRXN}5AW?#_yt^zT7*3n zd9_30D!zSVNonwMi!sW z+~>&ZG)P3-gyybIAQ{spnzdTAV3 zoq`5347I5~DS~+w)m&_YSoWmZU=YoY&&3kPUJt!#02bJEW^2h+$-CgXMqBNRK?$G2 zM0A&gG4-2kc{_!GWUz%CooAV4GsA7$?8hcc@0lc8FD^QenMZN!zt?fVarlC#+%Q(7 zp5Rr1<7Dl1`*78Jn|mf-wwJrMTCHezcc%(|4EyD)Yyt;VEJ{D>8v}vC1Ww2)#{r#u z7XBfFqxGygh@7w;(RDc?uJN5F%x>OT-}W&Ua7E^n?k={!nlCY`EA?z7D9B zT#D)sG6goX#S*7Ovv7gUAbTqf`@hx}{)7+!#miqpc+c0L=e*qk+w~d%L0{vPg8iaR z;Fb&%ijiMdlwgaHiS;iQrdx+B#RwHH=#T-V&;(m2zzI>SLm_P|LiAFZVYk?jK=-SO zqbG7b`9EPNGsI48n&s~uUVi7@r{?jwNN_>E8c3c?0!uvlt;>W_;u_4)L3zB``ut$U zw)cDSyTZ3i9bTG#cg!CPu=~J)%&5=}ONR&>5WXZN2nn!y6+N!h%yIdHNRdh4PESJv z*mPXJ)kL4PlV*jbfeHU{s^Vt?w4C66y;h0gTa5}J$RJ!#IJh-NIr7v$w1o25?gA1h z<9L7s0O2ye*Yq>^h5Z{@94$x*k>?7Hzotvau$aV+`x3Y7O;3ay&+LG6sEBwLNh z^4J4v%Sz!nk1g*FR}z67oeN|mgDig5qwVS?ZiR0hNdiDKe14_{K;c&0?#<_8+}eoR z-7Ht41!)=@_(p+kBI=ZY8miJaO%WUEJiYIfz#Mi zA${{VUe!-DMzqZOlatAH&3nRYi6Ja3bWx$))1A~_dyTdL3|gRC#mQ*SgWkyU?fDDW zpFP@mu_G~%lYRzhx;Q2>`xtghV97S};f^hM67CY8@^;#;@jY8#$6#S2kw#}C6*ruz zVMT9`TZyQ4!xuP&H~~w!(8VzxqV}o^0KXk<<+2!Vo4L?HCh}wbnt@-|)*W;wG>|sq z@EEiRtVR@XWESjr_`6MC5v)6-Q0KdVuyAR*Vy3qb+SJ@j_^>*9t!bn7St#M}Leq5Z8SJG z1Gqbf2cr2efNXBJe57%M8YF(6N1iz)_pJiBl>h^38@10FMdGwJ#jAciv7lXjbd*rx zU3CiO60HAz-j5SRNqzH?xyPux?zPhld)+K{)mDWyeery#ZHNxMQOK&UYpk>hU<^)& zBo24FgMjc>p@ZJCOckEFtHYG4bp5KLc0H~-2HkaX=u6-k$jyfwd7p-I!~DqExLsnk z4?c{(GD@O^-NJb^Xnw0Vp=uC0U1BsNK4QlIzhfPu=sUmK{E!RtjGAMT*RJwi>eMEH zC9msG5{TJ31y)X@hCH{o+m*OfB8^s{KQ0|DY-LRU=vcff#gsw=eskKRhH?;Yw7zMDC4C(IeF&*e4- zKm-s@I89-l7@(?lvA+C5#&U&8%w461o(Li9IoInUeAoBOuO-P0Hu*vmzux|xYSQ1~ ziky=OEdAC@uI1#smgJgC^};mK^YT2l@BXh=VzanDI~1|k1zDhY(qH-4npXF}?1*MTsyr-oKJIf9H z4)W<>`DJ{j$!{F+KNEV(ge&Y{mJ;<_0Ur1Tk1N1Qs3ptdH-AFZ=8C4T#51D(jrF`r zspZ3gkC-iS_VTwW6`Lzch1+2J-+Tw^yzTy9y#W5V(q%L9it)Jx&3yddzRG`6v9r0PqK;BysirPrc%QZ;xQz8s+vk zt(d!Z@~>C66xSb?crgc|m2tA`Pg*tQ&|Fuojt=}Hi!ZsRYVzW-4rxtpoNgderRxP7 zH`9dAH?>l|r!@#sQak|Bs|6a70+}D*DSnUUdN}FXLG)?v;)XWyBFTj3sUt|9ovec}#w4ib+7lD#t z{JeNHl=m=GtuSUh9FGvSQ;`<%)3PnPmZC3f$=eFV#wM$5KF{)r=Cg#q^d~Lkyy75> zp!}fKv{UrfU_s!FC2HI@c40@m=v9G~fGFPIpCMc9x~%HCe9+F&y}$l%%dffKouE$& z7G^Wy&n5E`=ek;`?`)_KA~Y?ys<%yP+xWSd>7o3FOgzJ0%S+|lRf0tv)z2ZBIdrG3 z%?$Gq%lzU}wztmJS7g21@4G9YCmRO$!6>9-r& zy1L_cTP)8TrEQ7sruvj8gs(iiyZk}m#CZ+jCbNB$^RKnP`qc-5{!JIgxd~^BhVX&2 zC-M&`^cQA3`V20#4Lh{@!=OD_Iba$>^I4sKpYk{|SgAwFk;7xHArYUA*S^ZPDsmlV z7$eOHr-RMrbr;=|wj>lxx01N+K{~T}+22_I{-JED>(lqdukM=vocV0fb$%vMFc$aY zRg``SW)QjuWyp^@pp<5Ri{gk(P|fsFrBRj@Yqz8;K#a(GYdpNiJkErLRJgVAi1;}d z)utAyX-}=8H_xHM?p7Z4NSRZb8g>m(s((UuXSf7p-nmmwjwk6L0I2Uff(>&t6k)8Kof|<@}ldf_&pmP-8Xu()JUsEGVzk`*W zLi%1bfpbgtY`4m*02x+`LD_ElZ-QR$a=#L1Zlu%Mm25K8F7DYb9WqP%q~s}%5wCC(sff9oON_}fQRLAbNghj!DYiDChYe4mO}&gNDL8*$)T3Dbytvx9 zvO_q3FBOmnH)n*Ke%iwJO686-&-*%eu>1l^dimm2jyBnL(;M4QFOJI&QsS#Id8zK+NY83mWMKQw&h|gR!Gna^d1CQ01%K#Urr+pPt!t=ge8$3&yofJVq04??U3iaJHI=%cT_u;eL-=9i8 z=qgZ&O}@PGcM4jHlYF6X_}EJ8-9?ZK^bFc!8=XSJ{lj=UQ%zZ?!VqYe6VElKSOX>) zwEg~!@hj*?8*fYy@9gA#B)Mx3T^~J_C5gs%kPM7ni=U$^(~6m=LB_ixvO5V4{6OJTW<|gkBZET zFBfaSlh^nqU&dYrhb713aYBaF)3Wr%wvX*nAd$dIBTrrZ+LHxHAaCYt7D@IEt%rv} zVLgqp39N0Uq{-=bf<76;GAy#bNt;M9LnrY~qt#0A9PJsw-LgzMMV)J~&}2I%;lGZP zpQsLrxoT|a5c$8hjem23>EKYEgz9NfThiLvf@OP_I}KqFF5>?}Ho9c}kT7r_sXZ+Eb;Jc9FOOu$3@R4$fmGD`ZEhDf zgFQr@GkD2U1&4G#%Bz6&bnn_YLSI%DJI+;C%W%c(?{DZ|dzD@33}>?ay~`pVKl2=F zX>o!;X}^rT2~=lFXeyOu3_LKN?v{&MS@wzQUQPANiB^k%S@6p?u7rmxvISBGbydle zciUVqR;L+LvE5LY*Mu*}%e;uL7X(Me4JvFnP>Z&;oTi#T`~i!Bjv=c~W^`@0KPL;%=XrB*XI@ z&3#Nq8$v)#uGRBCgzU?rAHVwNX(m?=*2$Q@*SqQWyIi9;Xe9q$3i+9<1837R`A1Iu z$JZpgmA{8Vhz;6OCK!A{X|(iHi42&uHBd}k?uc7BKv!E0X4T>PjR`AlK> zW0K3msn_lrWP0W=4227G1hZmC<;al*Q}NxhMdgjFBkxXOd8df|Y@l9Vv|SDF%%3HO zeQnUOSUn8Hs_gA*-1ZpDk1y5DT--~Ybg)P~dZO~Ke8lVdv(r^?Av6W<(HF8PMsk?f z1KfhBfeg*YCgxEix)PNyUnI4M!N}&+;3M?Y7%B=qzF@Vs^cg9SH&}n4FQ7gHazGj_ z*1vOL{|6*{W#D*T0$O3PY04s9Y&ZQxM&brN!Q6fK?|KI#a=J8`TPV!OxCoA1B3 z(3hVqn9O)*W@1^}5}q~IDu1s#eYX3Bg8=tSRaw?Mul|*Ir!3sv`=A=Cwe-HO`h&e7 z^;neGLtL1B*`hv!)G&T9nhv_&Zn}u4tEv&Gz@`w{%q$K6tlm`jiS0<+D zk^6gwTRHWqZCEWuN3itE*1EUW&xTG;!~{}f@2XV}Oxc=@q{163IldCzFzsOm#Sf)~ zJ35yUM*Nc(SG)sK8qJR({}eCsFRuH%X5MX+H2ZAr!J3mCnb%h8?(UH$s`xMrF2gYO z@@>qd9M7t`VjqS=?skNuAO2#a8{Z8^#v&%}E}L97D?Nt%rlA|6JL+5bFe2sP*9w3#S}&(AQ+O|$79%Vx?>dtsZDhmv1n(k3S;mF z{p-L1dy7tgY1;S>H4O7$%JQSt(uT2iK}jtbN7|?ha`(M@DYvw$90`Hx#9GTWk=yaI zPd`IUTim9%Iu^W@<;sT{ODv7-$dK%T5p7*tQr2^)69jYw;Y&LxVWd~Jt!SD&XUB${ za14lWGUuixQB&Zj^mK6Fr%xX$zd^$2?0=;R(|brhJeC4lR%IwW`R4>mT%EwD zgD?Lm#8u_#+aWz{E>;e}>qW0Ou#C5EUtlVV2%CvMv>xmHFBgW0=%f{8+gp zM-t8*hCF-_Zd*=~o1x$F0ROtkJrpu#Fe5H7LmQ%}QL`cW6JJaloDBZ5vIUdm_k5Q} zy}Ur@xA*a^ZRz)WO;J;MuQ-|HguV8@{=t;=we- zlDfz*xlhCA`?e4Df;b)B(#XFmwtk2X`}o(r2t-8kV_w{k%F}pC1PHuR+GJP)7@4>g!SUkwjjDWC z)*>p}0){WiirN=q=T_|InPC1$tS!HFwQkOBFaIerneXnsQ0xMe^m#MUX=s&Cd{sAq zNj@P~=v(RP)hT`4u{xR0CYyQQ620+N{np4nzZ|{v&A4q2Gs@&O{d-FILKRDwN`)OXmodbKpSC53<4Ay+pV&AM!JO6+maKAx;Db-$M?Hzv?w;gKn4)!42WTcZv?|Nquen7N6AEF+QxI)f_!E zKal71yv1@-X0Z8=pM^Z5OYGBug98gB>B0EKc6=PW5gg|gjVHxSxWJd*p`U6MOTuKZ ztikP^l_+HVN>AsQ*#FEp+5LHe^(^1F{cPj5duU%>pimU>#o=*SkIn6EdQPZi$Ad;{ z=u0y!GWw;}mnTTo#5N16z|B{?hb4?-Oj7C;Ezjo0F9^sC2~N}-W01-jl!uo;jly4t z1nc6r^>~Z9^ob&SH{Xp)Tee?zfMJuG1D1KVB(Hgtu=x%Zg8osZkKV<4h`o91W#2y; zLn+S731d>l$M|JB_6{sehX>iJtW^$OVl4yh?Ics7E?<^)O-!Bx6VYz%fv|A^I$XXq zV&WlC(pWR*Kr3U)p)Pa+SmYkGn(sEPUiU_sg7}}iML((8I7jC2ai}SI$b^`HSgN!m zXD9GnqRhI+c?8^RoL^3>J+Y05*wR=uUiC9t&0lx zi*JrUIQ>-pKEUs0%Y*PBA(Xwp5U{@%C&MPnT&!`DcEl;=K&xE!;963{k=wNGt-H&| zkGQ@!;&y%}UQjwQ9;Kiw;lpdI-}n)q8zUGxDptdH;~hs=P!^HL@WAoJcJ5#ggeW8e z-;gCY$LrUEw9@5`9$o)`j@sro0ON7~lF;!_f|@L`m&PlNiot@M$_g|z?4yvv3ex1!2k(|2_kn-~lE-7!sT~zM z`z2PhyVG#03rL5;YDzyP#&O%kQ}OJ!Yf}K^Xse_9^Z%6K-8e1P>JC4wN4H5eS%`0R zzk9H;$mZlD|JB9!Hac`2qMCkoPr_|;w@vw&rn&sw^F|yyE{RD(bGZu}q z3ETiZfIaLb1CaDEp|inO+bSJbXP_TJNPDO-4VPuPR=K$X^5KV@gie6j%{g9gt_|63 z;mntE1#{_(0gB@0PZv9f+kagNqc8k>!>AJ&@g2oCl_#^KB0)kGp$sbBXs7tgGQQZ? z=#1Jv_odrf{HX*c+p&-y)9LU* zzc>!3+-E;yN5c>9pf-gKOzQ>Px?$cTuV|3U80Zo#+|{m;FSR?&eAuSUC7}ku;Oj2Y zNPz90QOyazbA1cjA24@SJNBb}b`@+JR#wGVDEEeYIAR5{!?0?KzWs?&E5Ca5Fc3ku zcs2=>()=7uiE5E~uE6}pJ~1)o4YA*w2=>t+GCRy=)GforZ@3d5W;^*U_||6v8XuJ8 zPe|jg2FDxYckv4Eu5%m-3%{j=#j>b5^GPJ&@eyQ84bNrMhCKaduHszwYV4lWa&W`v z9DR}XEHWu(h69hUmIpqmyIfZDy~o=_BgZ>46V4mMHQh8;L%wJJxHW+U6!G)Bb%<5l z+Wk-3NmU?O=KH7H6%)yPFhAV-ku@mhBDQ>9Rm(;kvrK5lrS)2$cVF|i zGA(LwvG0rDx6+vD{STr^80ZHT`tm}0Git|N5@|{*eWS)?WGaIt)@6Wvsq=X=MhFFV+lU%z4wyG~0%Jmg6IuH$q_qox>Jdz=ivWGXU^OZy(^>He9^ zU8^6V6nVHyHF7WV$VWcP!PYv>Gb_h3nX;qqT?7qmB|WOX_fh$dxES6YOtRs?1HF7j zlmbUi^vjs%tS@b4$;*|n37?eIA}BVGhy=EOU7nhWI1B9ZW^BKh^+8eRDEZw3oVR>g za~R-+G3PaL2LfF%iU9SaOCe^0aQA4WsmHD4mZgrvqE6;5VU4Sdj_~s}mf|t5`*K3Z z0ayB1+bd-gz&+}Qy4->LpwQfuQw}}4S5hUe+_J|kvhhdBb*SAS!k>k8L|uf_s(|h` z{M&;+bhmQmh)vBZTa~r!2d`;2FH$Y;{1L`CKl?!+3~xugHXZIfP}PlC4i22O$=1CfVkz&L4tBQf|&YX1w9={ zrx@ukFXLi%-J%37o@~CYX}5Y(brSIOL%ht++BBZSmilf@gW^+spgnZl$lY)05+a*` zJI&2?LC$A8o;%v=R_bHYv!BHMu1mVC51BAy>ESMb;043A%swFn*F6zf4@Zyh^UVwh zqDOCT&_#X_{SPZFALiFlz2P@?vwp*{x}zSSGb}j3gYquS-go~NAN$uJYP3%x?agIf zw$TuR?Jr|empE8OrgQsCTg!p;Cr>-xuGXUmr_OxR8(Ff|ACF6;67FRTkd7)g90fit zu>xOj4BLP1ne#U9e$uC<5P1*9SHt>-9jBntp5qCMm1Nj<(1Vib76=`+jqwmbl>_rz zH_cCb^t2ZnPb!S0Jer=P4e`^SzrC@bneoy!fe=|Zj9_7zY#wp$3U-Ynyoe2j0k!gj zmsqAadFLKiTD)ZU)widMAw??b8h1oaXM0r54wiEQUn^R@(O+zH1$=6PzYzG|vsda$ zD`O)Ymaz=taAD-vD;_t|3GY8)=>h3p*<0?PnY?j}!%mR_3{gjs5L9WRc0~r|)`V!` zPrZxCip&~lfDHe5UIwuxEWY$$FkCtL=xHpQ$qd#52#@}a9N z==8~0bkdzH;?(C;FXrCZo_K3KTNR1sE|4GnEOP8)Kh!Sb3Mib|-M^%V^AFpV&(N{a za$9H5m?k*;YWh9ky{ulE1vJ{r z$=pm}dU+bz#N2wWnVNSPuPAHkeRc_;tlzO=fid?dJViK}YIN2i6{*ikWE(+gJV@BX!hkbJd10q|yD1@)h1iQ|huIEl1q^PHNZvnTOQ%-1uCq`)9 zWk%Mq4140o`Edt%;&?()6s|uIAc|FiYEPZTOS#bIx=x+#E_>~|_UT3zw3c0myJ%;% zd)n@nH{%Q^{+}OlpY(ItYi_>iB&mZDV{Xik=Yhtl(*xo+3f}C3#sYNvR`~Jse^f<< zt4(!bv3LudI~1Ae43?`nQOG|(>d~wqa<7S&lzZGsu>YVN;$p4XPowODe=?%;YH@8v z*7`}QN6o~yD9qOqWPx_E9;4iH{0-~oS9L~!tRGP-BzSqYl(>5;h`69#U9NRKbmhId z{QX;xc|gscrz-eE=@@-+<1?Gj14DOE<+V+;>wkR7=IOh)#7w+D?b|#+Jz=S^w|Tg; zI@3M=T(VNM)fif}P}w~aVQd)JvCI$x&3Tk_clkth>8(qFpYk$mM5uRU>HdqZjH$0} z<=x(Gm$|lX*3frw3S;I*cm}@0Py)+dh)@{Uy#zsvNBry`T}b5Pi0G$P)0jgazqD&C z0krO(l4__^#2OK1ICgd(wY^pf8*V!9NT9D}2HLw-j5w=1-vtb=h7*}%Z?!^eLb+Cy z^_F^(mQ|d-up??9Dv3H@mEvJ{4m?0t1_7|h@%^iqb$D(;^+(LI3>GytWR?*on~r3Z z;SFTm)h;n4qX+UuuTnRiB*FPc%EgvoEC+n~&TgAr)(79b(Xk1=!(BM4eZDv~eUSFF zwoH?BLq!pph#%253VM7AdP>{AE&bkQ+7WrPGs8IA8t&Vlc;q#bM|lK-y+=-VI@oi3 zo}9{ZZ@&K~(s8)!x$A7y@l_IP)cZYa#L0fKW-Zxu0<)!Od$8PPJ6*ovg0mj+_`@6^ z171Iw^mfg1;$9!kpv5e=%r5_80ztPc=Ufu`3O`jv=nO)cQL_1$Obk6Jzw6vlJtWXwl09n9=^8&2mPt1eO8 zfVv3hbTxr=cCkHV)(;DN7A&x{+%LG~J8PO?W9p&eEtAAQCW0coFh^zgMf(?_~hbnpzbR7);wuF9B_@F%wzxD4A(lS z>>QSKy@vYYgtFdbKDBaI{M2#>@#_ih_uK%VtI%1po2aN8o z(kU|?Ya(yDH~Oz@$&z!$oUN&VT`x92-a-2SDSkW9zH1~g&`CR= zVfoJpUA%CoI5i)0s`dD5j99)`se(v7k6ZM1^~^GI@9`)*-QrpG`zIQdIX$K2BY}=D z)+K&PS`*S8JYy$DuHH+DPc4&#)mKcuCxPXwRmdAxt~bz~Ftp`H=)W`KyW3-G4O%|J zk(4Gm!^G3sE6c0|>vnTlh%V6+NZz9w9bwLBceloplebWYI#5mmigE`8`5{Fwhx^S? z_rjB)$sU$pJ?Fy5 zvd&I}bsIdU)KAMtz|Jcj*%}E_BInCWyQ>LyC9ctcU807qaHh zXGLV#lA7P?JqFPN%{b?ho%J3Nx}2T^p(n?~W7m3}fhJ&%AJE?qw#x>bs0CbDttuH3 z4cps8DC&IAPt!ojUc()69(sQi0#ju{p*mcj*j;EeC=kydjLiGMsCS1XXq{<&cw76R zBJk<4y4Jmg*11TDhX&rC(Y+lj^B`YTf;1Xl!LYjzqdf)b3R*59I3BvCpgMROciB-( z(8PI+;b(*-Cp7e!J=L|A67b%DT(^0e?w7S)r2`Mh{5Q=+AB-)%Oz!UogryA!-BdmY zc8ySF%}rdw_~xk=%+q<8O}+iG>!UtEDc^8$KxMl-8@^3jCG71{-RSL!^o^*?fTTy8 zudioyL9&pNHK(&t^wI@=muS@4D>2V2FVeYW?nM6PxR%`pD0e!V>xJX$LlF)BcDd31 zeT*nac_2!+p%xW9v7-}0P8C~F#t;Yu$g(x%IY6waNt>P&E*y`T_t?_uA)?}*V$&GkH{FUHYIWW@?Nv4E5EHQb4Ps4A%&au{zMctOp-rpbn@;bFW z;uJcLg)v|b7VJ-xw2)mM2Tup^L{=5~h>tubI(Sba>h_w20*5xgvAr?5gjK02UoZzc zt>BG;=Hf=mbsG2L)R1uxhwGq|k~Lu0*xWeu8fU|m@RurqW;1O`9@DO9^~~bW`LMAr zS-{XyNy~ZO1=Jp3;f=O$ZvY8%A~_?_ZY8kX+Og@EPCut8sS)NNnlBMWt6%>PfDuZ#G zGO?Y|33~gY#;yGe8Mpm83Xb`?!8>aGoy)3nBs>{0;9E0`-YN1e=_<|-8zvTco@;C< z*?)aN5M>QkAtFN7U@mcIX?-vPRftAZhC?W6$o)49qo;6JWbncf!lz0+42z@b!lB<( zLgYRZJ8(Jayfi5xZ#+Jm1;^{H5!a^GrC*f$#qMT4sW6WgwaWjZksvE#!|@7d#ql9r}uIXB>FN$Yc#3Vnkfe8_ou zK9Dzu@Ig^!NrL~xdaZeJ@Qo&C2f459wQ7aFPcJJPjt(FUTsq?oCB=@5bjyaSe_1l4 z)e`9X#UD0PCKQ#MNZ4Ho*-$o|l1e*ovu4aovHFBg^EQXEoWJoZ>TJTaB_nwo@3iqA zCTE!40$=YM`DlqJ|H4if%Yya=T5))E>`m{zE-EEeqUx#Q!+rs?vY7ES+kJKLQpdJi zQO58C^7_rBJEb;Vks9FYDS2BNL4%ezBD)RG^Gqk`)^l+}d73b2$5~f70XEQpsm~gm z`f?FYT>6Tj4;ksW6FvX<*D?g$eJmS>ZM8&MJd6SNNLISBa!A}p&mv%zzDEcNps|Zu zrB+NK9*9YJ5pLCwS-4Tj2<1u(^hK}hyzaka=H3ApK-cATPuKT!{uHnGIh=v>H6)m{ z0#2RfwLOvNAp3p5K0sS-=Zm_BQJcQx{*epZe;keLzH=5?Ny(m|8Pma(a`4INDmBJ7 zjg+(dh7K&t-t)Gn#~S6;s{40HU5Sn^SDku?WqIayDBya>AKr%Min#$Y@))2^Mj0k( zXRGGMUUs@V=2`9~(C8;7kHZtc7Jj)5X;Lkvw0Vu;{Ex?PWit%unABE>XoLWcTVK~6 zHiO}xktBBGR#88Qa!0l~wxy0v75tNu36aBsY*jiJ?S3rF(-ZbJv{ zWt=-E0^839iQnz+W2XeykONyr60kM%Y$*W-%daTFEfu|ma>JYv3ms)Zzs>bs36rHB zvM?VTAdfUGP$ffE@Z`lK(pK)7qXBP7cBVaZ!UcT0P9Y(Y{WZ(k{oA95&IM{UyZ%P%;xB68R_4dl!d_ zeH`BVA(gxj2*gE@-%=d9z%wVOP8C+6l{(V#gMXtddg2zmok z3m}uGAr2NhyTWU;j&nxgVTD5$H*31BBG0Sf4SHlsXm-GN*)`wg;;5xxn9HQ2Gz3S0 zkzsI7<%i3x2kjixyVQ{)Y~<0)MSw}Ds###}a)G#sC9=TApL{V7NdpX2gkP@1MC^Gk zwrZm?k6f1%U^HqwZ~~Q4;}twm^75rmJA9U+@x6X<0qlbP2d%C=()CFm<62;BH?M-R z^S8#87_GT0cyw_wsvhao5ob1q*ox7z)p(NiC&N81a-F-p^40r|G7ELcVw=$^%BJ zl0K6E1(gYz=;ud0bR^=4F*%&pKGSOY49_!@6X0WE(SnqNW$TceR=EYah!u>_u@#T! ziM6W%Ay{`X=URK%bV($~Icd}7`U+?LWe3&jo%tWqYwE`P0J0zLh#%o7U9;~~Nb(2& zN%&pVXG9%)cO5xgQHSuEM5x}ktFt_rb)@h;9U9uj6*&tN*e+hU9Q7;oIUTV+t%IXm zU7}(=R{Y`=MMM2fPS;#u`tS?4rHYdwx1n9k&;}bie zU<(+3rrO}}%M%WPu19JmF)uLZ10PoJ0its~*I)jg=Z!nIf@9m|7BA{y3$mA;DQg#; z<*v1>fLK+>W$Nd~IS{rbd~aJw8yx`tOJsWbfk1HX=80)SMF~O_E+*Jg>9`hV5!XGY zdfVZ$`mi6jk4Yc3gFEdCazPT|5^kD-B(&|@Loe57BunuBltShsa9(Ep2xbc@vk>X~ zfyW*VvX__au7A`$qCTcVv!u=uY%{nvVz8IRYff$`ava@hbFO`C%$Z}y2UX3NW070V zGz|DUTmBl&sFsvsO8(qpgT8jiG@o{fG2EUN_$Oz$^!ff$+Wms=4>8qNz=xufnYK|fZ{<8HQUx{>CSsD|Nk713=_x+}+sFMUKjf3z0xlrp%xB;I$nB$3GE-!O=PvyIHq#%lITk$O7>e15fK zQ#Dsf--H{5*_ZP@02z>hojyDJoHS9aBwjCn<~=4-Xo*Wmo7UMbf3@RBMKJnTZQ)vj@hlMfp9u~>40Jq;axF#GJgWm<1E*G z-ffAUm19*pJTPaWGqPtU4dn1j8{kQ6oX9HHmGv!lXYAw z9pq({_f1mN0VS@0WWQRaG6NBs_#i5b%P(L+Sj*PvryEJ6VQ7tWJqmC;aZI!p>eNk> ziPyA0T&2ONlP`roD^SYD%DRYj$#AeP8qDYEbo6vLH}7)6$xxm9;sAsHaQsMTbsq+0 zw8tNG(|cHPR#fd)a>O}Yri;%587`!TwUoMNRyOWa|Gi*yUM9}?iqVkDBIs{SzAyU5D*i+HMv%x(IE zXL$@0*vH(X3isL?+f3)4AGE1Xrlcob7|6-x)4HCGsuyM*qLp7*Hf8wC=6s9H^PQ3? z^?HgNe1Zm=cqVM^>-)mIZ)@T-E{V8i3P>&QW!FsN&^tqv5?0&p)!yR5loPV)(e zS*D>zZ-J^RkwV3~G^0W4u&hKc#olRk$({@L2%{78t#aFBaHXwp#;RdRX?3C?hT zD_XXVL!p%JpQ*h${K-9>y)JC)$T|)!0%aE4NafyBT=t^JI$@E(?-_UW@OXUFY zZlYr&G)Bi2eZ1jX@Kp6U9kD-YM-AO%+=mL-a%`DLDoH($|22jajVH)I^*sMiCO8`y8{wU|+$U=N$kM?=E?{aPJ6}-1qRL4+t<})5=c6J&K(XRBZ^?2mTrq%y0 zDtO71uLDusda`=2A%vC%mI6UI1*qRn7Y}#QLune!>#nr-?~FCHifjFe95MT65>^;( z88rcO4UFqrj;#ToACvnV*=H6dI(1+MS&yPO^QmG2BK9s{*s9HvuBR;mT@C;sGALag zpnT`ltxL$;x$p{u=hMT5%eRT1vYDT5O@P!m65J2E*7`n8ckGK`k@7AX?j2! z5*WOct)#VIY#`Y-Qd=16IS0Bo5bsoW|36&ke&IocQ9N|3lV0 zM%T5!UBgY9q=*{ZcGAW++t{|#*tTukYSdVbZQDDx^{)1ubN~B{_tPF@f7pAiA1=;o z&WyOMYMa{`v$PBYQb1-#n4$z73I=_h_Gute4){M@r*$i}+7U(B%mbUF!c#Tq0pNGt zC-m3OhI5>b)&TjLm{jwrP1_sXiK5$4j(bOd632}qgqr*5j1Gu!a-JPN=5Z;^B5Z+h+Rh{`p0r{o%{g!LyXoUMW)WI^3n8@76Gt2M;kweH8 zZ7pX8m>tS5mp3vXfpJ)8IjI*|=wsq*l;ZSmO-7j?mYeu=j7D{cwqjZzg|f@lty4Z6 z_Zv<^Q!GV>1={q)^m3~>--*WgE*nu>CgkXZD$IqcnD3Lr$7Am75v)41aJ+o~3ZLEM zcI+1^33lMx?xEJ08|u(q>NXhn#400MwQx3K=|QxIjGx>aW@7^|zFR8VmrvE*M`Sw^ zX>=yQPVkW?>^mwc^_qlXcmh-oxILvfhapY6d*_)iSHIHayuwVWUtV96})E|YF0q!u|x0mk$F-9#lRyXMir*F4Gays@1`_l43Degl|KXiaidGFz>_$f@r z(q4}Z|2Ol>X}`+~o=9`+8o>;M5x*oxqUJ-cI>tXBSLLw}ch_llg~789wRAnY@oGP- zIr(B|>)n96`<>ZfY)LCQu8%weJ*(vyQ+!d1x#ey$55E}iuxB$(9X44rTlInWhSQ9o zJ^=c9ByA8;n;`mQy`~f4 z$Y!FD=5h_($J2H#Yirs{f75S4`e;&)t0rWH>0=DWMxxB1t2a2Xcx1A@5jcrU8geaD zy4yj&;4aJ3&0Xenx~f$qZuh7998%kX8eFkCKnAksa4y*C-4(d!a0TiH`^Me#f%mv= zl>M8rZVf=dUFAZ1qQ+Rv;{FiG=4@>^Kc2mBFQ>A=r*+5w{X#;-el(MZr(Qa9Mr&># zD90C$W!BLY`Zu38lBsP67&uG`dOMtfko^H(ivPp$m#c&T?Gn-Fc@H{cha!)X)-_lbCaRCuH`1rq!_Ad~+ zs)__7eEb86)P5#e?<+fh#*c^%-I5LLrXRQ1EZz=isRGIvZZwcP?q{#l{?f>1%jKU! z1uD*xoAn=Y$XU6#}+N)T5CofD4^hD%n z6_r2DbHo%2@gb5y*^s?=lJRagFG@e-mNh1etAx*FAARmk{mxt{7cPV;H=d+ChmZV@ z=HWo|!Tj#53&SH;owd;spu%{mU1q7)^5_)hPs~KM$i1M>%NWlq& zVJL8!Q;=>gmRob&slW}j-=Tj@U3+5RE5k7eu^;RlL(VhMlx40^3ZBCsAfyN{8#K!F_r%wGZYa`9*YiG# zgMJ8fxH($)CNl~Ex+(IKBZG^z3)7Oqck8|w_PfC3QlNM?K-WTgFkhuH`j)Qd+j2b#Tn-Lz zq7Bki^G!188%Ka}-D}^JPk!{xVs^H)+xBk1X$69Gx_B(-+lSlRh#&qvd*Y$@Z=vGY zBM->$(O2Ca#lNbSzcTW9^cJE-X}=H^~*YAQ{KO&b#n_EwKJ6Wuikv zLiw4ds{~t##^LsKj&2XAntRSIoSnou)~MVT^1SvuZ)Ga&4C<1yLw38_tLJKd+p-zU zYFf02w}(+~EID%}aIV^t*rVMDQW*#l*rUBi>bz>sfpk4KpY$_7zg+_8k93htG-JyZ z{4=;*liu<=7{$N5Xn8)jABouihBc7UINCqr{m5K$%yc)sicnEV?f-K_vk(w|cw2xf zd)st4EBOKb^n3L(z8XA{gS8uF+}=L_7R9lVh!D3QLRK|M7Yk#8`OXw5p7^y4y4Li zeTXuoc&E-mlt?zxf*$yW*PEhk5Lsf6`LxqTwh-LcnPv&f= z;que`JHHBJt(};$G`26OjSIFHqX)(KV%V26xl}-`sgdr6hVxdwV5%)gk2l!%kzgaF zSvm1HAf8w6_oy6>rx}nI@6}>Gx4+^XuX?@;06>Mw6=wFURfos%S?CmFo| zxB%wPp8!_$#8hSr;YBl8!mYfc@6E^C@AQUbRT>55(&5#GjAyA?QISiF!dXGi>)w4W zwq1HXlqB~>T7*UZ;A|T5Xq2#&@|CnuTW_JR?9tS%nlh<9hdBaT_JKh1?IQ-0X;@t) z73P1+A=R zBw>Oiv=>;v;y^uLJinJyE0CF%Ofr}F*y^*}O`V8rqDv#!oTI*?5UJY^?9g}FH8L7yj^wZhvPTBwAw6fkusVT zj=~4O=?!Z&HWyrWCT+k0#g!Ny_6G)AnBQFMHXH`ER>isOrO!!^ngcK&2C z_&;6{$D4Vv$9k(A!@9`Twv5AV+@q?6#JDLUPa*O-Hu8@=&CfZ)`V@Eqj7fG=@6b@N zw8+34(ffJBu20p_GnaT*+voH*$D{TGJ&mBR`Q4FJPHqZn8me>0WoE8DWA2M4g%9@!#U~Zb zr?jXlno6+Cwx_K(m#-cVUmQ;w_ZloSZERFlQjja|T6XomFHm{BY(Df@+#D$^5U?EJ zy7Y@WP6(kbiD^+z#p|BGesh73;5&pTf~$C$ZZ4970V3_JY{Vi?q6ukN^}grHXr7PO zx`j=<*O9_kgyxz$zeGY`A0{*|PFudr=;i}bjGK|+X~sN2pw!$BU2_IMk|Pwl@|z+M zP*L%|4Le+S3_daj`t*;lN9pgfR)nfv(U8Hx_&~NQe^$M~SnqfKSZ(k*4;I?%kM?!=B^KEl0bp+DR*0WAe9?h0irL z&1;t&d&8rnCvb^)hXV)dR*%QGs2unEBDm(*GqDghxRV->{DW)!?7QUu%D3pbqc6T=w;8+e2l(fa#11ksxk z;~$8&^3iC_VWL8sh}$8Yb`0Do&LG{L&jR@6ymWL7o#}yJwWRqjWOWBXs^yTaMX@0H zDgDN_8{E|hP?c$MTQCce*KTxVn?RX+EGul=m!@i?YdQO9y%^mOz0Km$RX-KNE{Xam z6MVF*x)DPI4TPzQ`ZOz09HJh17ACaNJkCS4X4xUFYDvkUtmH}i$aY2g<_5CEs6Ng! zT|69~+fg_uXNjyi$#rFcYbi-WdyV-5kIqO$Z?oNRHIYdRGpFI`-f(m=Wbk6;I_3UD zF;qkO9k!EI!$ru@H8B{~?L2}N1U8t6wl?9X86CUDJS!uHrtj)`l6FZ7nWVyrq*zE+ z#y|YJiB;t5bGj#xQS6+``6tp@wW@mDr`AHnzG8dzGmb3hDd=rv6-AXQU^)*Km?kS{ zcSkAFC8GOUy~kY?>FPPF4zTAYbwf1Elv@Ugrgid>fS!JR`syAU*LWCzSPz#7xozoo zsV3A1kQd8TskL*iN2=g)I{o+#`uxcA#wvuj^ejaCGmAf;FONE1#4R zk#;82={WgoBm}J;wcVSciFrvi6227nR2Q}gvJU`DW25?A9vtZpa+ZZ5L8sLSO!)XQ7npeMD)cUD z70UWwsCH1<1QS)oCNh+j<5g8Vb}J*XGnP4plErTY6`3O7WU6qun3)RodL%TY&)
    6}m2kC8adYPythZ7s)W{i}3*;aaae26x9hQzE@i^84G+<5u}mRF=l!}Zv{q$}0j?)>-(6U?_u@3(0jLg+v}%6u4Mf@g8JOcC>2i>O6~`oj$7#}^+I$39IJ;DgG>}JGw|;Fld6$&=qhiWa zW75?O|L|!!`vqXBX#v% zvVU^>mzJZZ69V&b8`7;T)09Y!bHNL>ir_eluo$Gb{RkpChD45(bW?E-o3A zAA>8>2S6sZikw-S2d$^9P_>^ywUm|M)%yiV-O={NId{vpW6){r+B$*9^)=hrk^4rg zN~k|7n+^^ZJ)SjTJn$B6N;gk)LSNK}=G6S5Nm|FZxn8=r63ic+T8?rCyR<4^B&S-L7OD&>4o^c8MX`2P!D2CUgrN#Dkv4Gw zf_IZVvI#Zw#@+OhT6$LK?JiGPWY#b5!duS6u&I8^EYe=5V-qB(m2om=ACt3PYY63e z^xBnF$n;9ezTzuWIkQL95mXjMQBFFH`XXPDetQ&lpoIa(cHsJ6Z~SD(to^!WtTo@K znpcaNB(b8M{@9AxU}MX^_V?N)+!0Eky*)9e;T609-fJ~s2I?B`Ib#ZQ$g z53nwNXqsupz_Nq0^4-tCWUqzGcMn(o`-N&r`5{0?O&g)h;_{MNiFHhcA4< z(smOqGyrso(5x|X{>RrPr6Qamy=8a4MO9vZZi;;z{_={f>9QYxHkFxy4ro!jE}Va^ zxC86~4qXPNQ3I*&Y+|4ckFJYPixirfZ}I5eF66ef1K%Z1Ri4#1yrph6r*V78^j1hnOps_7cCoKzd6E^?3bM1()4gQX z$n&U*EVOUUsu9gdjBWGUzLCx-Bm@1&PC_b(2}+SJvVLBd$mEgxeAtyJ&HW~`i;Sny zj6M+Z&We&1AW5wo9Hgow7ulgpSHc@N=^eCxlh)f&L+|l~&PC(BW%nVJwkc?Hq!?i@ z(^G{Nl+_CH7|@yaVH)6`CKMhmjPqQvSDKpF`V%h!ApkdcwFePt&IKH5#BCmgUi73v zsZ=suF0^3E&~{#mDvyizN10#L(HNJ?dAo9CV7WwE^~e-vd1!s=AL(A3za`>!XYrFH zZyP&fXHV8y7e!0H>e0^5UC8H9D^KT1ZcAK;RWR5+(=~=^*2aQ@l(?MGOTl&{ zBDx!8^BVAUz$W4*02#&z=^P@A`q>88Np zIIT8gJ?N(ku%A^CkqmvT$9?sDI&Y`p4u!NOsk&J-OB8>Rf*IfHEk~Z!a9jcB2)mBk z)5(S1LNRnsF8nW!!v!yy5uQFmXjm7a0OPF@`{c5eq)@TRRD|SjsYbQ)$ z$rycSLRlv_PI*SDF_@rbo&96ZNW|~lj76(nu2?p;_4q*P7oJoK=BmpUPx06fl~PoR zU}kbUOfpogj2ZeH)3hpy>L>u;y@9Y4J&8@%#WZqwl;>sm^i9>Z2LLL^9-4YiOc#3& zsc$3)kNF*1He{PzF2C52aVg=9K&sMqccwj8LHeib~B3kpUeVPryX9cHfUdN-6_HU7PbB zH0Z~ZW{Hl0^`A>8AL`d$r0%WNn8Pr>h)4WNrga>WO6a-wEUkj!_CTir^v4f$%Ik37 zAIP2ZdDGp{zdsLJ+}52WFFCG`ay0=Bw0W+q`b*AWn`HU}6|q zb-O2BNcfA-!7>&MQ@{04tc$t7vO0TrJURk1krcwCObC6ru7G_x^Tm5&pD#wVY+;Z) zOD&QlIhtHDDYSs->NP>|e|`sMx9fmSQf_HIRv0kc@0j z9|zBX;8Pf`t;wA%Q3RYo!7l_o-*-)KR;@asT#9jUH2rC3pwzXEAevJzACV(tdj`IY za#EQCs_rgsgtdSfYg5x(bKZ+Yi2!pJLRFhn*1K*ojwp;|KL~XRBo3YPL(_C3IC>nA z3XVOrnwSd+iMUmsqP+nGkn`+T__bhkYeraLjnZ+_siGpS4}fu_NuJeu2M3sS^5;{J zz4opNtp^*h5j?sEe08@0lFg@<99@`E=XLJI=i4PZx=F@UFeRyVQEi>UI0{H+iNRuc z_YHJjHTBY}DM=1A$K>j)S0d|A8NnXLQIl}cdNIa(%a1` z%0}sRT_6<2_eeYair`AnN7v`>SI*ltJu(&8H7W04N*-slQ!kws|EodZOHU>$3|WLh zr?Uhgi})*DX$@TR^jIUPu}(~oWH}-YM^Ee0#3dGeQ0*V%)eLg{P`s0Kc{)|Np2xzy$41Z|C1UzN^&)ILy>=7qt&u8z} z=1Ox8BrQL)vD)P{SB-PAKrlC0&=odoxa=D&YRpoM@2PMo>xDCIBR8<!wP8B zc|Q~w@BwMoEEq`=>S!5{$D`~eNHXP0z2Sa$$-a;^^cVGw=doGl4AO@Z{+l(=+p~$t z?=&2KP{ClvCG79gJRTr70sd7@L4X#PxK}FwZ~oWd3PS!PO!zsitTY% zNc?R7?F;ji&Lz8Z3gjW3$9dKd0LAhV?s5SBCf8N_s8}I3-(e@rDqLhknn6~!WtqE2ui2wEl%^f<4F)uZ2PPc&$$skh+8#I z!l=vejif21T~}Z+a@sG*Kt&_J&t@_%|AuKL1WrmblY95tw&}vaZf9sQhp#kK*AK;g z0Mu)AMOc8V8>ELUCl--F5^E_D%P-uHYqP~AUZEwSYdp*)| zU!6JLfg6H%HxA{tEUd(wx1ZDaWdvFHwEf}aXq$T$*hk?h9<3`frtX>Ry~nl3iWAL} z+-n02=rgi(Cm;48yZrPOhb1PrN40B_UXRD6wU5n5Ew+KWtO3_lS|+S=(+sxP^T5ai zAsH&Q3Ss;GZtA9!he)g(KxFMkuWoamsWvJj&d<5^+dFs>(c^y#Vy}dO`*f%2+F8RQn#G`n$d=XBy>CMN1*V08aX7qt_$#!H4*R-hLT5Sz zx^K1EEu{d5-xj+$A1B1lK+Ku&BATLrN|*9TTB0*WlCTz9vCuEHPT{JG*sx+yd+4Qi zt{v6m{4#T3p!j@xy3zDa&4fy?#}Pw2G9Xi;zoog=xQo$UeEp@`*!{(Muc+qSoN?+@ z!Sf*&Z%9o3Fm7=tZVPaIN|l#`IKJcYuXY=dIwMST)aSALqv`=hd)-JLShL7`z7-IQ z0wPA=XH&s6+?FhOmWgf3>t-oi`@X?w{;v5&bf^b-WulLVvzQMj?bx3u9)izr@aXlL zHL;E&Bw!DX`M4{A_Z?jZrlD!M2}SIBa=~CR%fBQHBF`I&JyO%eJRnagk0=ay zPkS(RKvd>*Hd=6BIiG~4(yE`}aeHBrQHj0Qv@n-@`Chb*sr|W-c2qM#B{TTdjs6hS0waI#%v9&0A>5?bfs?4Bb5hnM!Z!dk0Bynsi7) zMInJ9u1J1N%3rc4OxK_uw`U2RVc|3F8FZK=cA1dQ5y{2EkvNqoiRAkl4rNMUcGOq( zAlzpaQ_O)z zB~*0qWSMT_tmk>LS3$!qTfXn;s0$s-NkZG!4(5>HC10LTe*v{TTw0*Hd$t`bwO^6f zqII0{@-Wwi>9As8w1P2~!zA3pY30-1=ddV-9U6Ib23i1Q73kHi?+rE*Z8#4FHp@D# za}-n>msh{q=6A;{sTVl*YPt>N_gues#!6GR0%(eYkZvQKttm!~HUS+86J>`+gX?(} zNthoUoZ3u{gqyB5GvKyE2NSK+BV9=hdcS6rGziEB(kaNu(ufL|n0Bqs2rQrO&L1$k zgL`&E8eyb3{>@3%A!69Sn>xzd7&Po?AyE``AZrINbV_PGF7Sy&67-&T(_Wn=)kE@! z<|;~Y1ZPO%|A>7rJb(h8+e;ItKkA`B3g%$*Msh41tmv@jinzBHwVB3!%KJ+MVDiR729)eJIYO^?zEA)P1!i54|kCVn;$f> zK?dZq9q0B{J*ZTJrNJk|23C}SUNuj^8lbYqD*u$tibIvirdojxs86^4BFKEPi=4%` zQ7NBHbGzN+=_`#1FVxukG0XE$atfja&lyTyoLngxv)rs}*(3?U~1=yrV{{HU2tR*eyV!a~|X*(WRi&6dB4?yK_VK_f_`jxSK}UI1vJ%rizMwZP%9ux(UL(} zzbz|K0>`5-y0(OFtyq?=(lvKx z(2g6w{s{thA;3L!JJNXF;c6R~ZMwPuamj*0>}A)}t_`oZH{(ce&&-LfTsjRBHA*GH zw(A!RZ5=2S7Vcm0UiRCOi9H6PRh4bIsgcaPn>N759%@)U17KRt>|YW0ya?sd z4w9ddkw|)D7~Mm$Qrd&wr0SApIb(@&T7C;D*#^&?e%sY!6|zpEa>n>cf{8Ol;?v#o zUfZXNriX)^di7BICiQE1dzYPV>I$QwE+{PXD5E9zk!9F-^B{=k@9j4zWL_^;5JhkY zO^20qDCIvFODc>KKb?mGtu+`3h-C(C{FYD+^tS;GU2u>3cPpo(@wqZaep?Y70+C7B z47&SgC(W-Dr5{)$kl_1P9M`zr&U~@#`ATa3Zw(?kjtKB)iDASMb2N%|utOZEbNg^e zMs_I}BtAgbm2s0n49A4^%3^Na5@$%IK?H3vfwSQ>9>U-)F-w9?_E=3XHv45h?}4*% zty2sz2^YQf=i^^)6(pRTnIHhq_CnVfidVby%a{*+AZZ#5r`vgu-OV0)&-r{cwNYH? zbc(6-&KltX#slB?Z@;l`K&V!qj7{cAahW?)73;Btf zicK%3K!YFl9iH8|I@7FkdCeT4wdye6##Q+%b#4_6uM&9dE85?!pk}9^b+yq%i64Fo zd2J-9oxs$uI7G6)<-A>%KfWB#mKdyxB@*&p;B7hYt-WS#vHjCV0$#bJgO3-+=ps|v zd^>od_MEG*ulBshv^pK~Yy@QRkf_3_Ufc0|d6Ww=d9KhDp1vmLO8mkM7iIKK?o0 zUcctS(Q+|Zs>9H@Ra5Aw>QF3W^lwWSXvurKKy;`0X~3pRhxMH4J0B^>P+i1@+L!bT zpq0jA=9RULvwi6JMZGb4S(PuSz;{9T8VHMvsHpDdr(l-q)I%`jrvpugP%xI3{oFk- z>bcL}>F{Knad9#UEhZW|zbk~`ju~R7$z=!YU82|FfVZG1RdAqc@n28*4>Yll!z1fDw$;^` zFpDIdb`-<|DS{+;RX2NVPjt32D6%V_Ur&aQ!K@+W&WCJkB&OI<#cRZ1P;hL7<~=q^ z1lZ6Z!z0i0!dRCCUF)%)^9CEGicCkj(_1{k1?~XH2bW&`}TS8y3rpVTacDsg2r{|FR=D zJuPmDHa`Hy!~UeT(PQ%ZJ&5istMVf8LS}+R-A@~-R2v6@6c&lNDrgG(GL*IR z$AP$X#NDJ9vo z%|r&WW39HVoIq@gvAJCpvrwCp?3=mwR{UP+$m2ms8peOfnnid< z;Ls%U)@H2<^sj<2w?gcg+-E1gNq%;qWN{O6F0q_#X6`9kX@Wdid)Q@JELU5_`=A3t8V%GaBXY0Vq#AW z^!HXm9e_E?@qDW%czHt3eLvv7x6=984^*JFGx&i8*)6VLdUyE0(`MoCrMjvcIh=&7 z=df0kU)-W2q?`&WCIqab%EO=-Se3`HnsXS#_y#iXS2Xk6QMoUJxBJE9uECq)y);DE z9>ZC?(0YO0hp>zyJQOp^UsH6wsjx{yE?k;!=t?VNis;_YBmenY4;JIH-#Qjp-l`o;O5U6smp6;`k+$|g4s&d2AgYAG8fN_P1vUJwCzl^o@s z7a@5&WHG-u=-7+m{-n>`I7)!2;gIP7vAdP05L1YLh?Uo0x%d~-^zYT{KrrTj2)P$J zQklM2yRFXKj2W1I;YXoO3L_XmJ$~fUz=`}4U!=zZ(LLEaTp&HG=2$pKA&{s-|J4Jt z?@cPkytb_R8|3|62<>HN%PhSgn=Kl@dICym7}tF>rGp|DloRr~_WySTB6vNC)+4~4 z!yD@N{`%I70Dnnhvh&SA5$U~rR6=fO{)4fd*?9Py%!?A43Ts&}riq}Q;rwHr-5AVS zF9zw%V_L)g&rLn5*@>VOEt-H@xokO+$2WYvK035jpGR)A~f?yAA6eiE!&S`8QTQTS~swnR1WP`jL>Bdl)(ix#j&FnF`Cs zEOZtn=!Y;h&nGNQ%DQ?7z8diN)*Ap(UshP)-oGukKOZ0-2zqV=;s^(FiSBgrkzLM& z)*1E0Be7FR$@l9`Ug%>=!Bln({3vdO{SlLWq6IeolIA#{n@|TN)Ez9xbBVlVzxn!fF)feccz5>FQSKJd*rfs|1Jtq(}cTHmT1;5?zKQ`mv zk3|Hq8Cw|-mD*9gfvE7%WhMrpi@-Lipvn|#O*<~EYp&0#{yr+9J3@yC63~49-EC6c z-}6R4Ewm7YcRi7pHTQJn^DbQ8M?1{1Vp)G3pn5HBkZ4PK5Oq%tL_WUaf>`zWdlg82 zuL4A%(cjMi5`h?|C;1jLJy&}vczKbt5QZCWzxnwSm7mH0slV-;Ya=0~1a@d?#38+5 zes;SRq|AfVw0X(h5b11@Erl;!_M9rCd9u~WlQbyN+tOtmNt9O&v1=tmAis>d7-1s2 z=-eHR?4hh$u6^I@+@j1gf8Mz)Gx~ds6;WZjo&UehzyJpg{jAYIE3Ro7A^Q4O(OqRe z_yedHA{3g79Tn{oK9vVu@1m~G93hqP`$cS$M>u+@E}=EUspwm3NmGe?Mv0j3ebGz7 zA2AP$bQ>p#BA9I_0PlX*@7ij;s2|H{0<^p`~gcbtae%-Is3npy7&RC ziUtLWTx=;l9{qUwhegP+uyg0c84I`~Cg9UsuUrY9$4QM4~TbwHB)?P_Oh2rjQ`B zrot|mSP`=9;^n0*lZ1#?l)3(YM+6CMB1p#B+F@jiG@R|G?Yp&VX?|xktq+1M_7Z|= zr#?(oz`<@oP@%I3K`9;*vq)BE{)w?8ktQ=0g_DIeB(HE)r=ngojnIKPzO@|3hXO{L z{k{oTx&Pwmf54?c;PM$a!}hP^nf3bV(@@k(BZlK@e?+W)e0BICrbJ{4s5sFruRX=2YWZo6y(o!fJyL6jxp+i{85U$rboMJAHBTiRB!Z8{-S%9@z>cCuc` zMLKZYxn}CtwZ<`13>x!X{|lu5NnVBjpKy z%PK_^7>$>H3a#i!GVmXFV`5;y`x9vij6odmyT*{ns6q7(;bl8#MksG*iP-pRo{=?S zo~TYMHJ;~F^XNtzqZoxtumAn8zYTz~1Vo9rSsD*OTNria;vHk7HtVIbJsZ^%mnDf5 z#<4qTraMk4c1k<(63k&4+cBe_v#G>bCBi5 zJ;WtI62&74PirZ9r*XPOc_s7mqp_9jLwJ6Vv2iRq`+eAVoJku^*&h!8{J4K2%k4rI z8J(a|X^``;sN>JMszm^wIIka%%QqUvljZJVeYfrA&rw#L4KG0`)UEoBB>tUhEg`4h z!3S_it{8-wSMQg?gnjtV2c0Su5PWQTzf{P|f=l1Y zwi#==?$G^xdavMrCz3p@u2g@2J54B!K1_@-A~vCnGW5k(UYLbXU7$k@ES$HTQ-7Bf zg`AEJy7U0?BB#YcEpOlEAnRCrl6vQWVI0&xQMZP%(koM-7l$MsgX2ss*Es^=^rwIQ zf9dx6`&tHYdyY9h$E{I&jXXuJWHj=E*Iwk%<@`-3m7&rDTVY9X;v9O01W*;x^CKmW zv9|1Y_CrJBj-ed)VC^~zeRGCUQu1J~38uodK|KE+{cfQ8!pU3re7CC|9JBZ6yB7<#-W|ll{J% znH>lG|AI&UTu~4l_)lLySmGl>F)T4b2vTazCb2O7Y7NUVLnn(Gk=|$Ni@<-#a+F-Ra513=|7{td-g4%<{I+# zzrskxB+{eCl#|rlqMh_-!F<(KDr*y$wTkHw{Z4Np;hg;+l;uBz;e8{}ab-BIwA5K) zJ)M@{Wul|5E4yuxp~JCo&FW4ea;ezVn;>+G8m@kAO44V_Kv5aaYXKXSBEVP3ZStZg z@@C#`=wcY&yw>i^ZjhX4FnD4d%M(mtkVN-8FBnhTuN^3F7A8pW3(7wH2ZsJ<9q4{X zDeX}=4*xyKZ-ZIHhfnL2>P+6Fn?^ZXOyXTdyVsQ`sC}M^1eU`3x=6~36VokZwGJI+t>sWA7SKz3ra58r6Y^dZ&A^Fau%`EVTf0X6xVrWvboXnZJD#5soAOAt3G(yDL$t5 zM(4;H#Y>`4&44>oAPhDzpGno_9Vb=K$*)G4PX0epK$h00pr6|wCWBbkfBEMQ1acyL z4xt|zRk?l;47;^=c>H;0X`o+UBx3Hxz|s&uNqr1rV0?)xwl0z4elbB}C@=4qAo;QG zxfj=$UvNWs-iB7t%0{$&cjODnvTyRm2-z;yb8GwEFX%5lD%#Axb}9yinn8?0LF5UA z40Q!$ZGL>)att!Enwh=S_&m%$UUx=}|Ifz#E)y{eW@Vp>Jjb`}SA%|vkLg{lT%jp! zqy?5tM^;Vl2!$T#o@J@$B1?>_dM&SIPbfW%WM1)ZC5=s8)rP?P(!I#gZOP~)myv6+ z%BqL~Fb7ssG*HmHzi;US9vBZp)+@s;>fe_~^nG{w)682E3*U%@p@JB|pPlZ10HeOy zT49rLNQv9}sNqnAY`5Ldvy{vKZvI?=n=UtvUIX%r|Z2yif7E!_C_Ne1*`G0^1(HO9$aD~o@6r-UkpE=1x&jCR~%=AHMfqSD^GD6=ns zy5~OUZTxyI^e~uor64xzDlUrliU|Kz-1lop%S#V4NwG6d&Bd<*rrQ4hAeH|Z5-EtM zZm$=?rKP_gCCkt2NFv&T_~+Cv*HShiiMe`JEV#MW$6X?a>iJP;4u%epXoyLjxC#4r z;i^{3V9lej#EZN3X{w>8Q^Uu=<^pbn-)2|-N>kah`;OkFN~af*yJ7i22XbJI={PtC zrqJs;kR|QiM}ByuFy&W0g`tPi9l{y}ktQa+osZS1q%J;u{w9s@nOwvtB$Fjc{;wDG zZ)m}bMI>E=w8E(2VnJptq@g4s``HHN;Y&X9fEXCNR#oiJqirvKUV)~9vS(q2aN{D1 z&$4U1)^A`kJ|yUBr?_uzdrdp5|848{Wk@+b%h`6YuZ_o_FHTrKS z>mKyGP(si^`!DF}pRhOrL7PQvn|=#<6bzHmbo?8f-Bu4mhvX-E7dyBhHYPi!BqV6a zi$YS>Sxb4W%tSJ{bVB@o)tuQp*6)^<_j z%I4+=biC>!iJxgICwq+1cH}{WbQfkI{)@lQ?(dbTr2+p*l>ry>Q0ih;I?6mz-l1C> z^qGdQ5`|ZHPz~BTxH(Uyi^fytlUiKgFbuDKi@TOF3)f;yBm z?DOe$1-H6`Dsm>UJ~u5YHlMZr#zlI+!<{-YZ`e@Pi57yYmzZn8173sv-6to2gSHF6 zw-(bx;_;A%VK)wAgM{W%+_s}V{VC)M0{zi&kpWqfl?nwLTEKuBV?kWWzfmj|dNpF; zWQSmBA~UTp?Td?|g`|?!Xb=>`&=b|Q2y|nLz^to9y8i~y+|B=gY@KyHp7G!IwP~iC zscDAk*yKzM)9upTT)Nw3hH0j|rn{!Qb4<4jm(J(h@44^izW;ds_u}<(p653{$8o%m z1+&YpI^RrA%k0-2VajQogj54o&$u=+XhJL1U|D#??{+a*_LK>HdXcH?;D4+Ck}RA) za%L!(aZii!f9Ot9~vtJRjv3_sox1Fg>PjeMHZ!_?3rxw4Dt!mo5KU=n` z3P&c=qB(9@aX-YICfE0cjiqknMpvq;M6>$BRFOPKyjX;#<2$-Ou zbu{k0s-s1CdA@1w^XQ@SKAxP1zyp*-|E8yF|F9g%WY>X!_dY+`K0_odUM*sS)8!VG z!09L{Ew(j7HUb24k+|z>(xjEexJNw#_b$WyO1N^asg}il75LbSB{VMB)$aGg4Nm<_ za1{gJ5s1^72=S|=7N)rFQx@*h=-E-IN=G$?<5<(C?xG<}j**-BgKKyNc5knw_k&J!4T0j!Yff>D52L4a6jx&mlp|p}j7=XCp5l5NuLF_ z(-AoDX6@mrQYN+%az>^<^^}(kLJ$}Zlva8s$JAN=d31ZUk4Le=QSQRRq^>!Xrqtgd z1AZtdRP^T7^Sz3d9+=m$N#e3!O?d-F`_CZ)(Cc3w_ksbUZE{a;G&WJ*;=M~Q#?v%o z*a6_sRb5$j9#NeAP-aMWE%To}q*(IjWIVZ!{cPIEXrlV81;PH{*RK&ULbdPgMPNc2 z24={8lWARLM?|?6-Auzs=6-U9`xkE$SgC;cw~oFf-ywM%(um(q5WM(EpoN==5`wL~ za64q4fB5AMM~xCZFQHl{cBzK+mA2nMhciHcC>A1~NV_sfra*KQX@0yo>Se7OeFXsU z%%}L>?F~IQl9*o%7LCIz(9@Xii37pXFNcO-+v_!6wfz>O6a8-%!2RLTM#IV`TCh!3 zyETcJ&w)mH{SFX^xN$tG_g7nv!22A2zBMp^F{T*GW6?pVB)EeUh~En|=ro@J#C~3W zxAh01|L-UJURolC#hku2lWA&@ekbzFZ#Jco7ohEOE@}b&_Y~joY=D_|bOl4b#HXAj zT{dLpi4>|1@JOohnZN7-D?ysQU>kmEt&oJtx18|ivN*#1% zN7MyrmlWx=X-lkGb!)16)tL^Z4%7v>T<`&?ppLKM(!uW`cB=n8&J_Gtj@FBhx%@U6 zLO&1fP&2Kh`F({eL!#j>-POP4Ro|Iz=GKzp|HLO9$|p$<5Lk&MEK&v+1shyqS>4Zi zkohJ?hKyH?9%%B!Fk^S^lK*HF4D5UFb5w%W7!n=v&H^64Dn*5PBeBqp(Hznb^vC!E zp5wWmG5&Q9Y=pQFKrv_jGOyyfn`$w~43~8^ubXG2Z(YJr$H9ck)_$of-OO}P{hx>G zZ`$4`gaiZ{>p$Z3GyiObz+d|YvIj%s191fu%>ZeA3Oa1u`}p8U(^iCNhj~iEHMyoj z9rr(5`=}_elMP{-TU$sTCk|dUpcfEqnLB4d;94}hQ?B{%;40E;SFM1t#2(s52Zb-H z!Wy06fO&L+>GROv8CYzmTO?~{QQco zcJvH>i@*rc0C-z2y@*zBO?Ie+5l#aBS!1!GK{x+vl)9^kwCMJRZh*^FSZ=eD;*Vr* zLB6d821>{N9O*%<9iw{L_d#`{Et|ptl+a4HNc&@g?+uh<)A(3~LIdHuSFz=JL5cef zunsBWKxD)3hLfN@a#uEo!RYpg9Sy^gVb?9&Rh-h%lJ_d#^G{4cbS3n8{F+1Z%Zx+y z@F9Q!KtB$;T{!^+Sd^;p7ae=+TW2Roc?{H_ffoW5@iZ!papAKu_;J*`%e%1$ePoEc&ISddd#qFpiQW70K%VWnX%(40cN6i4RKM@$YGHkH zqHDHX{6;Ci38Xf!1EbI z=)(PjH>lLvLKl1@|9X4bd)OjsFIhZ`VcF28LcIroJANL68LYbNwykaNBwM^aiRCvB z1F%h}L2(uX5G;0d*2osIf8nHi3bDIwDN(#oVY&FEPSlvVJ&JN5cv~tG7k#v63Um$3 z=w~OH%WHQSQhDujcUyV=WOtXm(B2Y6sI~sPxU*pBueQRoOzE+zn=$|K53rDQ%PF1% z$o~v3Ul}M3vRYQjc=ZR|>=W-(Fc-}hVB(&CKKJe7nOagu@u3DdK{?GiO;;{(5b}ZV&ZI+if1%JK zuLk4D`yKTpidbGrZd-dGBTkZ!o$FcEXn4|?=l@IZYdTE9ycUDz9B=k zzTAU+%zWd&G4)bf3*lh<*+TIvWcHnwV?3FKrCJ0Jd1f1rF|H&$}JX z*?3BQkAfr_&2*b#<*dgx5k#Egj$nf@1L^k4{Z7Rm7GxgtwjaAGGiH7~JTYYTF_-+~ zRXSr6lbMqaVCn^}Ekwdd?(|OLzsT4`p46@HWXG~4FWoM`T>5)MCcDRS225{EEBS<> zg!k7j6N+jgShxSa}=;~vN6um!)8BVcuI8Ht zBR}i|tOzzzE@!dNFB>??p}>;HF+#-c3v_7x5!MsgZWq~#5l5yVXIrIS*qEDin*2bG zL-M&S@a7yi4`2b|z&zm87$+)N-K2-rxauqmB+34y$9(RWr3Th#vOB-;IMV2CoFV@% zSpe2wJ@AS){CH-Y1a22_hJkL63>~bzsJpknf38FW*gZcvc$v;KW$qTaa4)FNv-bX( z$)_GT;;~RFda(E(C2uR$K?RDnDIx1}t7;e1c_0nAsb4U_ z@xSfevHn>x-+oZIa%uUwKRkyIhot5h*6V%Wg%~%SQZ=g0JGN)Npf9f40~ee*SC1}$ zy<-NjlVs7xD zL9{lKDvi=r`Swc4A%_Kw#`u1B_m~xiN`ZKbWqM9t)YW2ikLO`gdz+2w=Y7)n3|PF& z^_xyk9oQlEdI@1OjQ2{J<8B893#EvhzTGtm$VVd8a?xV_ZC2U7VujK6g6(OQhtzC` zu-5dW?pgRM#rN8pZuLHaV#(ppu-5g=g?!c&CBPr28v<+$7d2a#@_&aTmHoZ4bA8KXedg5pOAVfLaO`qnSL=_vuKF|; z7mgv1z^DRu?dAENfyI?&_Z_%vilEKOXhZ2f3uPA#NOoFT*#{w_!Rx>L4HoABQ7q6? zJ(2FoXYl90pyr6m)S=_Qz~v?Sg>q3qn5go0_r**tvBCmH~B#R#Eo-p zs}=@x1U$ZuLjS&4bxfD#)o#9Q{teve%saMm=4-LDKU^litJ}(?)1Z8}o|R453^=3g z{{pp6ue|6u=Xqgpmu?;DhaHHwrzYK$SuJ;PN}Qv{C!+NzDe14p?x!krmrcy~L}jmm zo|;0KDFuFMAb11l!(iw{^o9P`v|E8ag-bj&+P~C8*{|>rd~(i$1BsVgq0h3IJ(8w- z-PXRdY0+-~Pd^EyqNS0ct;g496XYSWVq;{(^dPx1VY>KQDj|^VD099c0Yw$Xm5me>1Abli)j+5KR3Gzl zbdXi!aj<}nG9XZAj) zZxN>N({{oH&dZgdEHC@`8-T$3FL@0jYt5L~b0PHg=YGe<5km+ppWv42iOSHHE{%d1& z;4BEdU8y3UZ}yuSm#x+K=v{Q+l+cX^v2%e|l2OO)cvO!Tt&9o*;DZhIss;+R8B8IBqPhsDYZWW`qNMCsg)AUFy!pW-ZQ$ET~8$(udRP9f=W z{@0j+Y=2=f^Q0vkwOgLr5tXe~$v2@lM5t8mVA%7o=+oy1YIP>u>H>E6IHQohp>Rq` zqk&U)_bcP=U7mpM8m}Hy6uRCp3#u(15fVdg`HNJeWS~LI!(QO=OgSmW@p2tuohJr= ziwXldnnOtIJjb^`peEzmZb9=IY-&LwOf*gBfh}n;Cu(wD4wv zW&&;kCrp##t>*+ciwTz*>ZBx&Xyv+9#(iM$c#(L!hZ?JoW|rH$w9dH2XqJmRGPhFJ zy30hn)Jmv*;7!sVG81kG)2riKenkHDJ~wy;@adg`I(HwgZOS|;9%-H+vZLx~lN0Fj z>o;aKgD>F>_oE)K$6q(orum&IWOyA?qZh#~@22iO#6sz+@5da*_pcw+_+>Z&pHHA* zu*7Wij{4QDb2$^*Y~l)1NGO&*T%y(v7t&TTz1b(b@YliI<~0n)gEJb&)17PB;?EZ| z%g3nmwkH&mdi?U$3qtpKH~d5nrX?3V+&?c?Q{66yJbuC8bI@leO+gay~`S&I|U~SsE(X)*EYP<2r`$g^X z9!hKs^~~sXAHPnv>S|p#Oo@dLhHqRwa)5TC)35r$l$~sj7wG^muPWmCCE}2FKTY71 z&oPL)frEhCR}u$QB-%pb4t8ZAigh|R$L{Xg98GmN+VoUWc`d+`;X2)1T2y1>*^9NH z`V^iyvCnX`3Jd5^-q+f13R#=)R1$ys*q7PovF31zr6dBf;D;f)k8fELYj>qFqOE(@=XY}J{w@J8;5UasVcgw99Kz&>O1val@3f1dG0CUwR0~V4te*X zVT^Wb2goup{cK(CN2(M$u9!@?V_OGZ!WS_pQ7svVv)iw`8 zvbZo5?Ap*FpY6ZPH#()EWi0rl6dcAgi^h~eDF#bbPTX|>KV)S+{IjActx5V7pF~$c zlBlFvw8n1pi_5tg6p*t~^WP(oNyb+ZqG%ujczpaS zipCPB(J<{uDvw8AAj?Q80glPB*5DPDrc05J;;f-uVFw{uF~84S}%BU?rTdOK}i zlCAqd^_TE&^AUFbDe2BteE*{g{v>35_xRO9pWZNbb&5HIBs3fhLjaf3&av-)Rcz}{ z%xyJ5<1wp(ntawR&;;D!!>C_wJ@rjNc%-9;2>k`hzSfP5y|0DOwOuVxd-xVsRc*eS z7KvemvN=nrq=`1c39AvQ z#y|sMV;l`WFE5CtC%8?K1Y;N{D9)>GWpf+RcjFE|e15X2dTKo#eka5m^C1SBq-jnd z>>i_pnc2nB)&hP5#fW}1yc^D8pnKnB^48=$>yIUpV^nJo(X0q3iK&yurth0TT&t(vv|Ie5DCLIO&Eed@M|*O^;NFYSRiH(2oFchBvhZ^qec-FGcJ(E^Gzysz(?#pE7{ zqMi$bc-gF&hzMZc6FK`6G!s8k#%V-S^jpwbj7z5q!OPh;5n>gf>k=i;4=w{c&VQXL}=|&yR+j7>714i zph@i$?pq&A?9tb@Ik3rXPD-BxS&{6xd5^T!0gWpxpu&7&coA5gB21xGGp1C2eB zu3T}L5dyXVkw74#KABLqAkmPMLPM8J&*Sl|+DmbZV8g5awWNTAU_s>B%(iYGG5b|Z z(Hg||Yzr=r`LsVb6y$gl;_G&()T@pu=4-t^aHwX>p`49au4cC5JU295h3{}EX}a{8 zJ*(>Pw=gI`l;Se$Pp35(!Mx3gR=&zTo&zfJtKA_}C{Ta*_v%Rr9ni?e|D}9qzM+|? z;dv#ENYE;m|D&zgSYi6D%{A)H;}Z2ntc(KX(qMUl6l2t&{H6(}?05aiB=PePjs6;) z$fDQr4V%=yk-y>zF?Nz-E=WXGZT5AfViyq;3}=D1PtJtwDNyh-hFx|;9);O=-jlBg z((g&~_H4l|s%}bV+_oBs&zIIE*bk~r1%JdIm=W4)%nBFx7^Le0i`I*k} zBeWVHLacb#G`OR4)QjLeoeCGt)5q$_qL1gcb`BOS#2=XZJfQ6!)~_e@v)nUU{~%i{ z9Isl0le{}^If7^9Fd@?7K79Rt(dZ<%Eo~9JXZN|^U|%FJ3=K?_db9QbGQqVIK>jjr zfgel|I3egegt&;$rMJ^>zV+c$R_x-#*mA9Xoyaa}g%GlYh3q%c1rj9g(HnI@eY5Jz zZ;|UhCBqyi`iB%s%aX+$x?KNwRog$#rDPp2A*S4Ka~>{MS0m*AS7GK*c+Ru+wFj~q z5mIT2*jX2dg^KQhgZAmmkWLD&xTnFv+xY@XfJymN*+hH^*0o7H_^*QGJ?u4 z6E%tK@Ef#vF22{_vq%}ftx=7}K;UIf)JkaE&nEmW!Y*yFBd_q9;h=_zyNZHQpl`kr zfq0lM?>9?(L>`+BYO0Ia*~&)=;;rA=*3~lziz?~Di|TiW7qu{58yCDwfy*+H#VP2c zUoC6)x)Q~Em=P2DHinI0d!Fl~zBFod^mKo;*sm4)l`;-F(($ypE-0^%2&AN0E#SOH z&T2wIeWDJ3W%5ei_~!Z+f$=TZ7f^#{vTaD{RnNyu9mJ= zjvJ(-nFukcOr$Q~-%~Q>&JJ04HTvDz9VQWXK%(|h&|8D8&~FQeZ1Zn~ z54WAjB#Ud(d{CwHx1@a*;j(qC76^BlGU`Ek+o5ozZS<3$=h1jhu;*O16l$cGZ2BsHK*Jp_W3n;T@m#zOQMxGT*3!Skt)Po zLbHGL9opJydrj3rE?!3P^N^j&i|Q|SvOyZe56%WeP;L5Cr7jX9FFs#O!W42N%impn zkf4@HybgCHMkR_lxaVVu&8j){dz0_<^tpUek2XT=;Qd?%yBGDb zZdUQ*md$J_#ui!XmP5JSkI|)*AZz|xy^cc%Xhe&t1D{YsTDJCMah8x`%qUt7iMa;% zn2@(cG^m4@FAtoEjg_DkyxBDxzJmh`=*mQGCp^CaZEcZf*n4icOJQYIQGP#m3{Jm~ z*W$0QO0r4T*gr z0g+yDl;R`klO%uIg}i~8x`}1x6o~qDcAfRzoB4N+qgH93H%rQbnJ;RzZ>^|IV(@iM zh=q3K*`&TjU$GIPoJ4b5fLUc#ZBgF5kk{m!Jjt^y(I>am_{D&z0;Q?Ib_4>H1CWiz zqi+|dOW4k?Wg4Bdg8o@qz+nFJ%k!&-hiu-?XaSVGg!5L*7LFnmEeUa;6l_8mWZ>^bn`&eq{S6@ z-;rb=NfqkCea{qq<4f2gBwHZ9TdsE!?b~4PQ8_nrQ@WhpF}h;Wwk#tH)7~|Xi8U%} z-nnZ25&T7zv?n9aao3D$iX}y9e0Q@{(xFV~8uOxk{t(uEv#ca+S1~~|&I3;QbF1S!nICLMo^bT+P@IO;@%UFqJsa#YW`Lr$GJ-Q$M$8TuOOQMe8hq-rP zpTJo9hjf7_%qrNQ*b{vc<36zbNabdkF2R??@cN#2QJ;6FLN|BBD7x0YR6LOag7`@z zy|qsCh#z;#WTEXC9RL?H2$Je+4_`)Pe~lbtpnYAh{nwH|=tQf^J?;XSmC8f2O~XI9 zHS*uM;M>BN=&WDd<)$ZTum0PqsX$zOMTn=l$8Q~Nsk?8FJh@ri_)|Wh7lqI|uX>kt z^_>61XtDnK;lYa{tN{aD3f9cQl&Z(mn@VcaByXE$@O;JjEo%hyh|g{v%w|Kf&uh+} z=5=?(Ql`3Nez^T&9>MY!#DV6K-gB*~dmQhz{p~Wj2Glo?{h03yv}3npO)3TPMNkqA zuHwyO6^kz>H?M@-7h`*;@<~2uBlW|#(fKS5b)z}6HM|>NtpJS2}@TC-%wc zuv0%_4_OCL)gS-H2-b)Kyv==4G<(g9<(J$R3SK_JRopz2%flIw@ogI6Z*yjU{L5;U zytCr-Re6v9v!*Q{jDlHb3VTl}h=7$HBHUT!ghy$Ls~Q_WD;B7RI2pZ|Gc3d7`WC^g zaAs);;m^U<@$>xVmjS24~%|`Yk}o#H6#JifU*$o;e-fPIcOq{j6EuEoy>l-|v zg}1KxRbPlvwcUL@_-Ix#1j4ZG^l~&c*DIp|LYRiOX7*5$hEC2c+pZlC)q~#nsa_cq zRDCVEL&<~JA=ge!*A1p^IXY0;wAs@2(bMmW+N)C#?(3edx$gceV$*c?&_3@DRDq$_6673zwv~DSKOV7_*qwb z&xD_QE(-#{YdNz0le0KuzvNVX{P=Dsx9C?})_;#B00xC9g1Jb7U?vhbdjUdgu=5YH zoXsJ)NxLdIz$-07rKXnGK~@ohtgAz3>S|N`k>8*-;p>T}D#@5uiOY6@UwlHya(6!c z1>gRG{MhLXX>>!vsKuLJqS8%z?CZmYXU_sC0FVQ$LqqGhL107{QE*86`&p z0#9K$^yEmQ!}U!)*0VvFq`fB3DB9Rf1eii7aX{VA2(KUY{>>s~FCLWU%Z zvh;h?N!5>*twm=HH5$QgEpcjbDNfmoxVMwX?uB^;?gq9 z$)1O@R<((pEogH+kKe|O+gCu&Li>3x04XtIOY)9%<4*LbJlYk0mTT<1kGYU8m@g66>q;DIlRz%1X2I)_zN&0^6``LJIs_ggM)D~!8+w-vxRCDE` z4R{oF#0ZwJ9^YAJTp~Zj+9>emQspQi^Z>jZZCjs1dYYXdarI<(xs;ytB!5gE6z8B; z%sz1;m!Gy4B`eH6-wAx8>)RBF$9ob_S{dAokH5ekYgvoG`aW}s z4?zI5jCb+p01AA4zgEPBP!!nG_)y;qKa*$1_DK@mr@T}*nJv8fd$yF&S2=#T$fqpu z^OuBuXQ%6HrYWERo<*?xpgwovIG{Gg*sW-e0ESna3OZD$E9CbmblG!#$jTdo1f5@PlOD(3WI%@GfHw5j-O<>~GGDgY9|6fjrc%9BKLeP3^O7>;WH4`rD$3L`b8-i>x zF*dac0b5%O7o)m|iPPmP6ur}e-_;=>Fm|Ga>5oL>zPJjsOtt;Kh41@3-BVgtneXvN zCyS)n6BW;e4cjn?b?}_!sG_m(t?JGLYlVSfT(J9M3CM%>oZzq?5V_cpo z6z~fEDFG_hZ4N)Y_quf6^yQPOc`x?gX_j3(q$tBTpNzIyE)X!r;dgdK@=O%oWTv+A zvT_c8-w(YSS!BIz>!`NeDfct3Qze^qehR8|BXi{o8*(V0!WW!h(8%`(LeEgoDf+9Z z^^>nzVW}+(%=)3sF6C9djpJ5=q#@=xQWL{_jzI0y))kzQa}Sz@+cJ42ez6dW7QK$c(cF?{i=bw_w|iRIHE%IlN2X4~o* zc{uf^&+tBFkY@5Gx8Tumt;3J#2ex3>e8z4)#&y!Ky}8nvnM#wT1|B2bQTXdrK4;u~ zZ(O7)TnY&_DJt$C0A+#-xC%cz0y?63Zn`*Y2ALzEWftemQy?DS>hF5$^WB=oUV43R zo0mMRaBP)1HP9?EMs6BN_zQVO6s21&@$7VTPrPol_j6#=oI4tM2JGPoOoJzl>!&RSUl!uB65F5e$^XHPr|_{o zshWO8chsJC+k00R=nI>bIJkwG>kWerV+?lf8}&5zii1%-I)YpO?CP9^@WHru&3wWf zE4c^Ygg0XAt05F)D^_e^LqG+!@ICq&d_7$+HIE8hEN2GCR01aM07CH>XV2l4o6FVM zf2od(hk@`YYEM6@JEulU43b2FwD<=rtxQ#*e<1h#Ufd~-8^w9s9VOF_^;?|9Xx`` zTNd}xd_g=0=lFg8OfQ7V3aDPWRJ zk*Oxh6bfZlnjShc_gTJ)QR1&h_j!%(wVVrbjZK2Mav5Ec9IM(4rYd?7On#$gh?;zl zcI;gJiH+)10PIc#$mgGytS-_hw3h^&(@YxU5+$B602JAa^GNch-8cKv};!!;M!kw?KuQh4(T z1N)II3u8_>#OnJQQejkfOt0jA5zIPC$PYtCu!v>`Dv-3@XiFa4X(Yf|G)W5U3*!-R zN9OpTGR@bJYK1vAXuSm4Lg$G#E1JQ%f^|BR$0AodXs^$LPdD_x>^a$U62FqUW){J#qq-MXRijl4!!PM=bj8B}+wgHUiwov1 z-rwp)lQCF~$NH1<$UR`P|MUF^eiU@Gt(yGcImN~;PuOm3xD9g!6;=l{5ou(@UxZ-s z+h)~nD8RMzWC|DUWhX(p0&tc@K$OVupWjXN^&5}F+Mlvq^wIqVXz@}Is|7a-)9uwz z0|9F$oo)SG2&Cnpu9@Ipka~xI9J7o9?W+aB_CR`{H4jx!0(5+jsta&8NmtPsF#+8s z4lGpQ-tF*x%BP;D-L&*8`hZX(owvs=N3v0Cpx<3wF?&>5qHnR>6JIMdwBQcletCN1WvTR56I6Ke?!RIT1e;&{bKMK za50s|?tBDK&m%TFWXmRqS!Kn68~3156PAngS<}-|9(b`?_G>N&((P32(}Y;&@yp@%@iay((;A2Yv(58*x#`=SR>|fVgv30R5*+bGV|^%8!=e{%mrjI{87Z?tQjGy zn5pB!-oT)}BoGIfF?DZe9L3G;;TPsAdw?(N09*&%al{HB_0B*E%lNB)H~gGj;)%k4 zt;9h=u9qo(jjBQN798i<>DkXUx`5nKYfIZJ)_YcSgo8?k8FSqZ+ya}$n25dp1-_aI z0u?M6Nb9$VK%cyPRirQ2O!zN-bL0$^apiWr+9kMwQal0wNIQZnn>4oNAuEly+@Eyw z8aH2;5jY3IjS=4q5+({-UkadE&Ko3Y-_{CD=b3KJQ-s*wM!YTLjBmdzbym>gBT_Pz zWeP|s-6Y#HV~Dql*LG;1Gn=~Oyzqv#WUX1Zo`&NX>QK^nPY&W6dmRC z0%~{S<@QTBq$>f08%}q4`sxFe2=D_!&WJ)@4FfFbjew5B;byn;#v2lK4Cwg-3h*Y3%)>`@YSd zqvzzL5vN2_hh@`7&#GW-FhRCubtAFH;v1=M?--Q{TY?wyO$u#Wc7^LXWx4x^jZ@(Ln`RB)!+bcwe%{*|#T$F$rpmlOS$>~RJ02hna>n754cI{Qh{n8Z z#j)x)7a1nhx?qUS^k0cGxIS(FE;nB?*P(tuMB*lwh#XMYRJ8w^jHuD+Nm%#Ua^3f3 z1Y-J{u4c)ukuvE14O5zi`~Be;{#=m8`%5)tfL^%`bsSGDJ0s;Uxrsxn#PZJo+m9%2#Q{-rmpKXIh# z?8X+R$^rVWS#$pl{a1eQ>Sck&5AS)+$fX0u#$B&j{#p&bIc3VBgH`jWduHWK%UO!C zm^fNjH93$}EO~4DHWDm7%V6SxBRo3D9^vV_k>AUSZaydw7!h=+Xqbof$XHb=JYccM z3SWtIDSb$=^6w}<@|aG~dRLKglLxJ8-o4RRyw#e`wpmtp3J7vum>S`HDYH2NT=Uub zX2FCJCH7J*`%+a6APMZx>`~u(^L4e%k_Z*^k$-he=2Wom{RXaN_#GEXTbmzO_m(%s zVE51Wu#YRleuqJjV zdVB_~m+L#cQMdaCrH^JwQ%&Cz#ZW*r?_v`Cx(vk(Pz97oXw`PYG*<6ccc(?JM!3A*-R-w~|0h?| z0mFt-A;rkfW&_FC=e3b>7p`BWbLnloH_(l#Bs+4S*9jzs7V$!@P`#h<26Nm2e6y~o zXtt{CTwO5ZMF&i3;)TR=lAGp!>uHyt(`taI{>Ub25?i>fH>&=yCSB4fzfw}z^>TIG zeex6fbNC`Ls0l)3X(^i!L^U&MRsVycU5BvXXSW9F_N4blXtHh5cOsB0I*@sG;dtLf>v0l6d&E3C}-= zmr2IFp9t4Zpei(!z&5AiyHvVaYym5hBmFL8E^*+ZiJs-o;Q*>oL6u+Yb^zVQirw_D0svXocBj>}f!_2fgc6zBTF5Pv{U*k3*^Os}*U zaIpRWRrYiCi|d0=Lpq&lLWhc{!m5IR}2ze245kN3t*JCL^k?lF~;H2^;tr=%bV5 z{V8C-yxWEQp;j})J?xiR>e5HJumnZcw`feivG@L2vzv2Yd9b(p@(d*wh0wHL&9@$3 z3N6i{1(|hz1^PtD7jFy}^3{%4{b^H!h>-WEg064)3D2?NUyT|e*=p%uH46sR3kD83 zH?!_F-7m#~XDo+Kwga>bYYIL$AHL1rdROu5fOL1gSQEXavx~>cKAF$y>89g>7Px1 zshBb05tr^CDJ;s9Ja5$SFLOJr++|#jujq7&=2(UmCap`s60m(bctoG(J$LG6{LF<% zcMz|ClFt`q-SdoCXB>-}CqF3m*bC3NscEMpw#J6n{nh#qZE@Au+zzL43C+=l4X3?5&T1PFxFRO;{SwApxUr z)-u78!QaOTe=#b*r=yXv1}f4&Vl^MuIWuR=e>R6@ljS^?RXwkWX^I}^wBzeuY`mfa z&O2r6EjPK+i|EVWN|Et(E_3e|wa~@HXFkE{Ear7e{@FddKlTj{RjRXJ7oXPBSyyCd zn_tvR|NKCH={-XH`G5e?*Kqh}wnOGEyI+fVv3H~y$*4u;Os|h*?Xsmq*Cdo)ziizD z=(IIoF%y@Y0Fsu<$1%QGbo1V#-h~uM#l}ysCyk_9Beoq?COQ1ug^-_ACLvc!IU?r$ zsJNMzu4;z-Rc`su62XmAD|qr`B7JT3zx`Vy+`KL8&tPLc8)UQE{PoFpp?yt*1%x zNS?-Yg5T%0>V%z|(MxslkvS|v9bYuU`|nH@D*g-BZh|0QB4%pxIo$zXs_7J&ElR~% z-+|(Omxtq88=tWIxD&=76y#nSE%q`;+F-H?%h9WDoQ_7X->R*dIn`4Q2Vl_=l_Ko} zQmC`sVOSmGzVr4zV|~A^NlqVP_Wf*@el|Dsx{ztU2QKzy$Fucs(8zHj3J6Gd3@9DLz|alS-JKFc z!%#!Vd+K%Rb>H{@|31(A>HTzn1Aa4{``l~qwT@NCs={Not4C6|41`5ylyeBwm#s}hER=k1Y zXNb#UtgN|Dp^*@nK}_p67eIMI;jB)c|K^N!sYV`OZrLT82PHUVkxvvLxkqrX%?lj% zn()tf#mB7lsAoe;$_kB-lxi?v-3@* zH-glCgX@l;pDS0W(05{~n_Aa*4dfAld}_XMRXW#TEG+0gYFp3@737pVv`>6_%lt&t z7u75g-rOm)kBmm2_PFZW`lMT)1B-+vjSQ&L0D}U*+X{L$@>PSlkx19GH0M~jLlic;$fG_p8h&^a z$z(VRyVj)r>Yhe=Md{nHijD9_aE*QFysjwpNV_guO|W=)*=Lt(?kID1SgxqB;v3-KqJPs^I%IBAom!qnogC4@gF<#fGF|B5IUCQP5Z?Y#?(MG0Xd9YWkl0O4*4MFUxd3V9nW0+(rvT2fz*y7ZeT zhhEPvuq?11th72vfbufRh~+T}(bmI5eH1QmIP~|v2l!xYzKyaK^`%6Hyd9X|UKu6K z+fsL1Tz%P4(zu!N>LMJHM*cO{@~|)7soNuU{N>Em$wEu1>Lq|gG&LD=J&ZE-`Y{`% zd)fA7KcW`qM}docuh2Z7ehMp$T9%f>gVBim)Sb7`u>IC6qJ-&9Ip$(YJBck>jqDj^ zVQZxVo5vB!;FV*kii~=5Z5JkWR9IF%d0brd>_#N_m%P}xtGHP_wx>I4^*tuc+zT3v zj@4?c)is6Ld|jm@g;70{3D*VUb=r~rqHv8=sTceOlRCSq670tkuQp7J!{3~5hPMaT z?B~o;YgSb)hs~%koOABRw1|bElzFNbj5wFl&K>En)h&|{B~!fRj;!$qG-qE$drD0n zV@EJ`U()-ntglP9XNJ$#C4}`QfT;o8%sK!b|ZSCMwUX?E$u`gOo~_ zC9MoHe@3iJWj`d0v3N;^Fm!d*Q1`|=1p!+bm$M4^X4Uu&`7;W z*A5S1bnG5i2rNpjvgYRcZeR99yv|kMD0+iS1mXnfODwVXlhYZ*a%v2MUKci;Yi(yA z)8(Xqy^(^A_iMKgpkLd{fXTh}bMMBPt%YlJxsJHC!taf{Rg$3dUr!r_pG>9eff=)i z;0+AACzKp_C#{OWI~=!ll+O<5c02SBLYOK(Gj)y%0HZ+2Dw2uA77AL_}*5 z7;U>!RNTzA7@am-nnA~#iSF@qowb8__#GeE`?#n%l>531T?p`cro{OjWU5ArpRZG8 zB+tSz?o!y3OiN}i8{!JxoP{SVLzVH7(r4Wab}Su0)b?6FYl)asAt4ofrs<#i-N^SN zy2V|RGCMJyeq6!3QeiU(5;7mrun6E^N4p2EnK#V|Xi#t86CuZT+st!X>S_&Yab9SMyy22HCvcP+E9ZQ#Nc zJC4v9xcR|5Ys{KAqdq5(J(ZlRqCxgoBs&~%Gh3gxG!)C(GT}-dm-{q3t3~bHJ|nK= z_&iU!YRYqBx2FBSjXWru5$89p0q>6Xwd;2yy(c1*fJA8>)6rOKeM~aEJqPY7;&0bd&l#N}8GLhtS4R6~g!C!B&U*G?t!U5Qa_;ahf6J z?(}}ES0<%O4)Q`gWQ9g1p~Yw7OIBKCP5k$UN{7{rD$td{2D-SfZ|Vx!;J~+ri*xUM zoseH>hGtJMdN(%*wb1?@!_2bbMU4SX%W6_D1hS7Q&^pAh-b zZs(Db(mtS>QqWeQ*~^VBN|Te7{B2;GN9>9$6qa$CN9Nein**L^iSZshQ6Qp2R=!^3h=WSVIAHDr;JMzB7Zmk#Ge2m;8gp+SDn8&K}cRtS;izZZGKf1-l zF}O>MW$09wsjF#`ZDiNcZJU0~84>t12lb~DTf|{%M4L~IN)Dj{h<5vq+LFy zUBh!xwU^NfcjNS6?kJBMqTQu|vNEZd4d$`*Ff;TvZx$H!UTp?@FmQ9g1xs+QL%x%f%s#!Hr z>EF8p9E>z{{W9>;baN1TC`QDe|=QVcv|-+9Dn_(7fi&=B7Z0u!pSEepNEM}8*EXK z7CO0fD|V$$t(XW2Q(zCEv~G71(~GtK5NQPW_R+V8=I55^Q5oian0^a;!y7*xb5`Lq zyhQQ~=Kf4JJfOLahyH+O?)LO?tgi=pNQzyJ#vI*xKxOJpKG7AbAfNg7J8Pvn+kDie zm0yo@WRnTQf23G7g*+Eu;`7+LaOkO@YE2qkubQ&0t+B0!L-&@+Zf0G!eXq9C3h>a~ zZY~TdC2~{V^O;V_E4b~q#Ww?U)68}nf#Bo`kFI2e^8-~6yp?h*H|3+BFK{|_QtYU+`?*3d~E@R#guakVERLuCJsxHBDu~)Ps+1U40;=~WZ%;nH;t0SikV%CmWQk=N&)7KA)Zk%vCy_8 znx*0&4VTK+`eWcwC%hdneeuhQYU-6CpU;n<=)cYZYAO=rTxV(JY@vK{Eeu^dK=84l zto#=FnACA0WZ0^!6nY-1+C3e|rIn=(OlquV>QXkS$!3%bg z2p=DMMH-D)=RF3ynQG|S;^~SeDNqfWRkDFlQQY@S40#`xdNaEwgjX?Rt2D@Zrg`t{ z+NdyTT29`ZqAf_N=4mUY#zdtHgo;sfud2UFhG}1^cZS0{0XoH7PqFHr2*||1Tr>6ND0Nwonykc30(_`F~KlD7CCg@oxLiR%Qv;KF& z__#`(o*m7o+3vpJnT;1k+eZ?l$r0}Ci94(3F5a6`TB$KcR2UAln>0rLGW6bEa}Qb3 zOkbc7F4&d!Wgidsy9ts?-?zUSg$#+nb}EwZ)VIF^I{bDzUU9FZ{>sIQkUtr8<9cY% zsWL9RZrM2-BtHsUw2O<~pxhTcQhZLB?{ZYTNYJxj$~{=yS&zz9wC_Q3o?hW?JijfW zVapO(8V<|MjZX(uy&du7@mFd{60FA}Bd48v4aoI_a#8JXLM)=H3J|@b+_v?e4C{gVSERT z5BM;hZ?1%&%JFSLI#&>jzoU+eSa#~PK((##&Z)1g+tIz-B!$zug7mgP4Mh@|;9cvJ zg>rukzSti?M2OW>Q~fK~JQB)8bpK(uP(;8lQ=RxplX(Zfxm>u4=Q_#!Sg_CWnP06|Csm08$ zF#zA#T+#o6ByyO-LDlgVUYRGVv^!H-@XWq`7Dm8O1q8eeAo4(*#}b9l!fNOZFEXF{ z73Nf_L- z0S9PpT%>JQ<8_dv;#}{ogaPiT&ftQFIiIxpa5G>1T?GJWQ3`QD<`e-nH&{DW%Umvu zYd|NC0e3u7z~hlL6SBP+aEY6x7?==mP{ZJz7e_fKB}A)$;T2m9Hsa?HjgUPSM$I&JS|FMuRV!vl@G#~i(H<^n=4%d2}z{5 z0GU_FU6_W?S=Nkd*I!A9UU6~{|JmDAfeCnb)QP2)AvkDDrMwyOd4aQ+3N@m-RdI%z zypE>M5i~Svaml()a=6F~rb<4xh^?My=2$u7b8>tJA|{f%^#v>LA&nbvI2T~c9uDGC zt~Ky3{`f>nX%k`P8z&Mv_1e%ag$n>r{}sObsl$6|(efjmc8kLYmeqNv%in$_>~^i8 z4DC`)EpQ%=?Ud-!VA7Dn$}E#{YmgSOVyx`Ia*8bQamM!3DtDK#9J?6W76TnM6L>0N z=Pa+*wc_1=s}_Q$@_jkq1)A4DUuJ~crlu)F?w|VorE;))(ui^p_MfM-^r9`TLh2xn z2}I48M^8=x76crisQL-fJ*$rM%fkU~?*NaypCRV}fUg!q>&sUz(=_j6-Lf2c4(y4c zLbLN=;p0ghd;6xt`pwD&Zfnzra3 zDc=&bj3X(y!^`P?z|Jk48AyfsH~9G(HYH~P-P`8dIG)7C`m{CJI|fh9UxA-a-JK`o z>TnqF0L$5%^xF;KuxD&yr~0RzPtK4P4)S164rb2Ssz^lix4F$aW& zCgu-#wLv9*h@;~e;caB$16A(sX3%*|56C7q;upUEWkmqZh=UpskN8@+MSXQ7z@|@* z^|EXbMYL$~0RU;{&Wmu{r`w7qj?e|woU>x%h~6Q2SKaEF(AB;6H|#u{LX~d+y7{KW zC_`G5fy&d*^jx%TDet(xrtAMMAOm8>bBajT#IH^cwb}F?QH)E`%8R9(*uU-?iJj)A z(NbZdNmMDB#i#GgeC3c%Cx^VtIDqATH7Y-K7@=f4A!YRqNgkW!bE3uUT$;g+oU=Um z3*`RVuUmf4K8XmvFI2AHa{p{)G|M4VIrVzExlZYetl*lmF;#3$`(-H6HXQ7bCed02 zQ~|9$8WW)G-dTBX?F=eXD_5d%P}}?f>h@5RSC1M!gcaqTbOjHnZQk}}3`*a8eMgwJ z$;gg@KGENpS~gZY&M3$WFKR5R^$stzW;|aW?;i~LmlL34{p;HPQpfZ6UWZ4fSgi7} z6-CxYbW1rW&fPnKbnLpY-Bo7f;D`D6!W|muoC**Q%A5L)$+JhxT5-wl&h%7K%d&h- z?s#erypP7jNGcPF!#9SbmYL%^Fh9l?5V08^oAiF<6Z=QW0lCTtuS9Z8&qGfw;P0o< zYb`PhmjSBD!sK}iG;M8gC?v#-&`L{`FhXtF9c$2r)^2U7M}_q5+GNN6j>AChEGf<7 z0(m58POg88^0vQ2LaNlTXH9TTW^(F)*ntWDMC4X`FlYj+$}p^)vZ<>28%SH|Tx4Q$ zg>0s?eaHSzw+FxTgd`B&{aYdiG)>L#4J2ex|N0#`Vqfq3t+&yK_ofhnrTe^QMR5wc zCF7P}k!}HvoM9{>8He()J6#!-lGjc2G0zGf*DIn%a>tmIt2RDzAFG|sW^yX_d9BRq zQtjHcA~~v&3XaGwI(L}Py4lpOJ6^HbVzevG+nRAsyfgoAS84fi@tfP5(C`bveu^Cq z&%uZ(@lGWOvs^wh>@1+uDKjx}Mzy@#%One1)tO$=vPrW{(WBRuPqgWrbd8lyvS~Nf zHK>PZe@u1Vw)V)V_MI^0f@-y+81rKE}E&>9idy)Fi5wGBcHR|4EE$JWdL z7w7>tg8=uZ-;TS@f%)r_{oITfe(RM>*66#)@Y$;ygDD*Z zDXFM_HzL!#D6T5^YhY6dyD4nY*f=u{xn(RI0x6POL%%}1J#iR~rVZ_QF!^BvfQ{2^bjrG{LOW}I;`H8~<_soI=I7U zbn*SAA%2SI3kTpXf8ns7{`eO%2P}>pxyMH*?Duzp=`;N~IH&@4yBPs@^FDg!Mc2`X zU}UNGb@Pp$w9Ay!x#pzjy=Bfx*~pS&<{lZL7}$kDk)?IJhL#J5XX!~3)J8QAxGlT; zwo1|)Rg|@mp-Nf6T0(9GYoJ z4@&lAL;N)A8Vy=i!vQiiHkW3MEkUfC#F%6ydq#A=Sh;h~g{GQ!spLZsQ$O;4bsA;F zc`~t2*M2NUVzK3y%y!&V#QWIIv9}A`pm#g&<4o9o@k@^MVj%hL?*ko;c}6h* zh;3a|KeBplfCjx+skKX#qkuOiDnq)T3TwI-3tv##L2jy_unnfYp(0(PnR;YdU8Y?* zZq=2w%w@8m`$mI~yFR@ENwJY{SQ5Pgu$hJ-K)Vhmqw(}E)klTHPMw8@iVI(A!J{Cq zLfQcBxQj?aIc#4&l7Bf@f2%WANqrc1|2I)PpEhPo87K@^Pp6dK-w_oP4$H$m zi}{ijN>7(&-7R;;R!(`mTC(#ru?}R{$*6q9I+eeMl~uC<-4Q?F31P2> z$mEQ^uQiA9!eA|~|y$=s;jPYnY0HjIQh2G<*)62EuO2G7aIr~qk9M56+Xzr_ zeATIKtc4C)L#w#s@$ADyk9ObB)0`1Oq?uA<9l2UJvMiZrG3yT_4za)8K6qphi;qnzUl`jnu2 z*-!@@cnx)@ovy7toq0C5hIOdvZQeg1_NT66MM<`+{fZT2<26sPhG%p%X-3wVv+wBs zL~=l)509HIp8<74HM>vhn-zVk-9088pyo$v31Tgt?9Cy`Jb+KICLsw_v&ACzqz;oQ zrL~hhVg+1Y*mpTN(@%%+QXO~(3);bO-_#Q%R~*nOw`M0EXj~qWxH@O(SF>dDbQil+R_9ZqVbQI0ch)j>(xft@Z#Iwy&TEv$_ih=cp`v zLk;Iiy5$fVS&wBt1OKx)#*nvvfYDE-)B8l-KDN3UgwSLOFZCAKg$2~5g0|0|ZW-pE zeLRYp5Z<7RH-f90!&R-{fb=}F8Lkd+@5ibYJHVOd1m$W-R)$1?aZD+dBdFSO%d4CP zk2bR8+-iy@oeFO@rJ?c5n%O=5Y^8-;Dh*+>+^gJkK7Pg8mymmZ0EvDkMlp+iX3z-f zpW{q>Z@ct7vly5>Q89v|0_35Uh)Les=LDf!jg+0du9Y)eZf-aSW( zO8x>E^VehJDpQd+$CMX5EtRZM(_JXHDLpJ(zEzPq7*o*X!u(?b>1!tEgKl%6I4s9pWlqOtC2vDlueu1;*!1X+2%z8S6zl zwim>)Wfcg~gE5bEiF(9$(EPM*!|d!BJ8UJux!Z3+o04&QAX~NxNqa;3`%-kEx9$w3 zFQz03B~9Xrr)O3%JV~owE3N$#>i)vwr?J%CRtIwYq?P^Wq-Q5L0rjqS&NOmB=-WoY z-uej-@|d9+_tE_P`Y2b>A`6%|C2~X9&Gr7cVW!}QOqf-3#kIewQ zR1q{eq2tAOQ$=ZEg3NcDExhIkBx(g@Zw+65Z(oDya;ELwKiPLI*~|hjm8eF?-y!sI zWn1_jk&nbXkMf*raOpsrbgT-x&qrlHgWox79y@DyJ9K4gO22g@^7-$`(f*B2S7(@)siHLk6h9oQ!O19}HseED&>PSYwfr4Q^0mKKSEc zi0B7Ae}~X{8CdYrhkDk%r)P0rLJvzhJCo=D%-ocHUvbbr0o+5>V#cim`hr=rxS&Nl zmh8bSnT14IRNp;JcmcH=b&cCvxh1G6Vvk$r!?-t&X^{n@KBqu*QV}L1ou4xvwDUGg zS@q*`%_nu-jnS6;ePdbp(9{W7_+~9||5^AsMAM^qgVQ;b zzyC1&y^a4Evp*N{x6|+oA}@ym@Th%;rW^S$0{$O=!~|ACs~_>{50w1B|Ks0({lfio z<#uVb6F(FF|Mu+PANh~J(%vg(`TAZI`yV;{kKbaM2R^S~=bf(o=#OIgpWpf`Ip8dz zpiBOLTh99?HwxhM`^P~Jg8wfo{?EtxeE>EUlYsKSLioQP(_bg{ze4!m57U2d!vB7w z|ErGvSGD?Ib@U$==0Ei{u!H|qNB>nv|AM6c{_(%)=zm3d|3ydt=dti9PdXKBZF zd&w{)?-YP7U?g_bZFCC|wQ0JYF0WoQ&)DaAYCGfSSyvW{x)oYmTJT6u&$+E;>kwu< zYDj}ef@_GRL4PHL!@*_*`(JH!KthxBqdLOWq{~-s`}4m3YH6q8SQCL&7`^2f=5jF~ zSJfRE**p`>+IU-9vDUC0U-IXK{Bix>H|0J~pyGSKHPoH!n~J9*uke zO_8TTv1zXGW0d-;DbB*As;)YNyhjZNG3$x^0BzoRz{FqP{5gjjQZJ`|Ian0-pKINqdbi+u^DMRTB6g!t zuKpT(z2-6bfZ5Zj%lxo4EoW%)Wez^V?*96pNVMN`DweGX%@%^+ZvZ5<-rocEG|^tM zNykM(SBPRRaY9&HGi7*HF+WPGHGX$#hQTEH%$O?3h;OE_u)wlJxntbgpweVv=8Jtk zj%s1BmaKhA(zcf5SePsS6ekgN&lUFtTLOfhb9ymWc#b&r^!tfKEm7H{f8AuCCxeo= z88O%K^EcEsYskN*cA1l^$k|y3;4J6@_3(Q?!7^VTI(JMwqM?VY%ASvhJNMCvZ`)G2IN%!N|={XSOOs zGXu=)b7u1!*@+;ZS}5#EV}~CRJg>O@5gHsUnAE% z+uz!)qyMvIx6t@-+&28w+`UB1I7ZZx)|l+smT?kOVY0>?L6Uq)H*Xt*XB^WKd=HY= znx!9ITAiQ2X8LF0_kMcEXaf1Ke*3t7-ygeO=XY5|H`-9a1OYz&EbAig-W)Ksr2d7B zVdN6FO;P#R95JuCB9v;&m~AmpK~;qG*8|Yy=*n6kgrDHUp96nI#iHelJM>T3^D%)Y3ZQDjZG3mFaKbOsj_srDO};^ro521v^su7Y5oHVHv|^Ue8Mk z_ynOZlSh%R=7ZLu{*`LBjoyq-ABFxE!+mA&!$+9ld#Lf$V-QBfRPv%~si>(%IN7;2T9M(S) zB_Qyl3l~mwou}a*Vmx@!#=k-b8Wxl<(aIdrIafBwebjq|lE+J`Tf63`+dse$N z+c3j=k@qq?6{)O=a5oSwLzpV3bTjlEe4|^rKBq%fg;j1HUtt&Eq7BP5e-=gR0JnfjezaZ&P=3 z(dEm1VEo7IG`)SC@C_e*)}g0xaZs#L$)4|GJMB~TT54@~d=Tm*0Um+9CR9*ai>K?o zi|u+fI@`>mx`Xb$kI_B^*OzO;fk5|@P%pp$V=!eBk5N!qp*d-?25t!;vK<_J$&Rn* zAbEO?K@<0;KKqf->DS`3)nrbmFro8=cYT}_T;1KhKr_R$ab2^WVmYtE>UKf{po@Gx z99G9M{I?!V3~nl;D=LR_*QBgC4+DgZG4grSX4rNKJ$fd5q|$<_B`V=gHf%ljy~|^X z=NwwT7{&2mr3^k9tTg`l4hl^EV#_#*fhM#UQJiW|M0>aEv-Om%n)9UK9F1H;Ajvosi4GMddf3s>>UkWKq zg~H2}<%4Jld&gQH-uVp@zSy8tG`89$XrUi-PK?TcS$F~PYxCLjrQ3z zGoYbQN@|;L&``XC^5<~>@_hU@DD)5Gc`6lV>C7LdpUH6A?Qh7XPPFndpFEQamUd62 z=6u>)oGm@2&#*g+-~G=)W5G^vCa@WJmo3k;coF*MHb8)(eLA>H_MmpRMjB{o^xyF) zJN?0+cV@|RbE${iI@dj^ned<2-F=TRm2qAJs5CY?4PG5aqBma5AzD&BcX4&S_S+XgyEc@68ln0Ux$rIIt0x!;62f7CFYUOI?gOFh4*B<#&T)BRq% z?6UegmP%UY}d-vB}TmSf8ws`pR zh3xBtl;$2Al=KovG&SXZeQ%C?NS`7kwJdrT=o^@&nvsUdn)R9ru1Rt!331afl%gIH;AGq0hQHt7$a_=K* z4v*(m&SPw9x~Lb+M&$C2%2*5zR=O51^>iNlob@;sUOw`@G~xkfH#L)bdgTsN-2PiN zG)>Y(aIbfSS!zjo#rsMnORX4}sKcujFylZeJ#!+k(l^7D;gM58HEcBCB{aWR44TpP zkZ8jGGnLfoJ{xMuO}{Bsc0L;sm{zwp^gMQ_s#<$@+8Oqs9UYQZ-8i1Q{kstS_jx>e z^)>0{C`DLhElcbEngmw4M<5asgG-#yR;ZrYkPkVj@6LPslzPA*vetcYn3Ww`nM_-ASg-T z=b;oyO|eraOUn^I*!qe+gxIW})cs{VFwUU<1p=;PRQ}@XA?)Nkyc_4A^Zyp-N9%hT zug%dstYhHq@BQ z@_lU^XS?iDk2^KP?|0AyP7{lqX z>l{to5hKqzBm?sNq^^xRC~x#jvdo=*ojdOHh9ghaPIxr>vD6DUW$FLLL?!_yGGaqM zg@+XwCf>Z*MUz$*HQ>7#vKZiI+~@+gtNM;^aDBGMO#>JMJFcWOwTvCL8)OmvP1?<6 zj#TvTW$3q)D_oQ=g&w&fv??2u?Q6czA6g!SIutz4QcdaU!2~^BDCy*kTIhBxU+C^O z>Y(?HckQ$ucbV0-lnOyf%HvDBGpt}>Nj@`h|6ZNCz3LE-E=LgE#BVNuG=e{8@8`Km z$h$X+lieS`!@aJf*~h&!N-@B%wCye{IV_M7wN@i^@%CUk!u5GyT6zht`86Jy@yjJYGKf1#23DwUW!HL;JAzH6}X}t<;LFyl~jsv9=kkWoakd{q( z@%{`qCO|{r4Ah@;25Zhm-vo2-PI%9p>)=)_?1C4ITNM1mEx zI-rJb`|n*h{fUKXg|ctXi*#Cmy(S40T20vd@$r!=_S~n∨-lB@{Zj9f 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 Date: Fri, 14 Apr 2023 14:45:44 +0200 Subject: [PATCH 03/78] feat: ability to use local embeddings model (sBERT) --- requirements.txt | 2 +- scripts/config.py | 1 + scripts/memory/base.py | 24 ++++++++++++++++++------ scripts/memory/local.py | 10 ++++++---- scripts/memory/pinecone.py | 9 ++++----- scripts/memory/redismem.py | 13 ++++++++----- 6 files changed, 38 insertions(+), 21 deletions(-) diff --git a/requirements.txt b/requirements.txt index 3f7fd228..88278435 100644 --- a/requirements.txt +++ b/requirements.txt @@ -17,4 +17,4 @@ orjson Pillow coverage flake8 -numpy +sentence_transformers diff --git a/scripts/config.py b/scripts/config.py index 37be1b21..38cbd142 100644 --- a/scripts/config.py +++ b/scripts/config.py @@ -82,6 +82,7 @@ class Config(metaclass=Singleton): # Note that indexes must be created on db 0 in redis, this is not configurable. self.memory_backend = os.getenv("MEMORY_BACKEND", 'local') + self.memory_embeder = os.getenv("MEMORY_EMBEDER", 'ada') # Initialize the OpenAI API client openai.api_key = self.openai_api_key diff --git a/scripts/memory/base.py b/scripts/memory/base.py index 4dbf6791..e3924d7e 100644 --- a/scripts/memory/base.py +++ b/scripts/memory/base.py @@ -3,16 +3,28 @@ import abc from config import AbstractSingleton, Config import openai +try: + from sentence_transformers import SentenceTransformer +except ImportError: + SentenceTransformer = None + if cfg.memory_embeder == "sbert": + print("Error: Sentence Transformers is not installed. Please install sentence_transformers" + " to use BERT as an embeder. Defaulting to Ada.") + cfg.memory_embeder = "ada" + + cfg = Config() - -def get_ada_embedding(text): +def get_embedding(text): text = text.replace("\n", " ") - if cfg.use_azure: - return openai.Embedding.create(input=[text], engine=cfg.get_azure_deployment_id_for_model("text-embedding-ada-002"))["data"][0]["embedding"] - else: - return openai.Embedding.create(input=[text], model="text-embedding-ada-002")["data"][0]["embedding"] + if cfg.memory_embeder == "sbert": + embedding = SentenceTransformer("sentence-transformers/all-mpnet-base-v2", device="cpu").encode(text, show_progress_bar=False) + else: + embedding = openai.Embedding.create(input=[text], model="text-embedding-ada-002")["data"][0]["embedding"] + + return embedding + class MemoryProviderSingleton(AbstractSingleton): @abc.abstractmethod diff --git a/scripts/memory/local.py b/scripts/memory/local.py index b0afacf6..40a08f66 100644 --- a/scripts/memory/local.py +++ b/scripts/memory/local.py @@ -3,10 +3,12 @@ import orjson from typing import Any, List, Optional import numpy as np import os -from memory.base import MemoryProviderSingleton, get_ada_embedding +from memory.base import MemoryProviderSingleton, get_embedding +from config import Config +cfg = Config() -EMBED_DIM = 1536 +EMBED_DIM = 1536 if cfg.memory_embeder == "ada" else 768 SAVE_OPTIONS = orjson.OPT_SERIALIZE_NUMPY | orjson.OPT_SERIALIZE_DATACLASS @@ -58,7 +60,7 @@ class LocalCache(MemoryProviderSingleton): return "" self.data.texts.append(text) - embedding = get_ada_embedding(text) + embedding = get_embedding(text) vector = np.array(embedding).astype(np.float32) vector = vector[np.newaxis, :] @@ -109,7 +111,7 @@ class LocalCache(MemoryProviderSingleton): Returns: List[str] """ - embedding = get_ada_embedding(text) + embedding = get_embedding(text) scores = np.dot(self.data.embeddings, embedding) diff --git a/scripts/memory/pinecone.py b/scripts/memory/pinecone.py index 20a905b3..b3aab33a 100644 --- a/scripts/memory/pinecone.py +++ b/scripts/memory/pinecone.py @@ -1,17 +1,16 @@ import pinecone -from memory.base import MemoryProviderSingleton, get_ada_embedding +from memory.base import MemoryProviderSingleton, get_embedding from logger import logger from colorama import Fore, Style - class PineconeMemory(MemoryProviderSingleton): def __init__(self, cfg): pinecone_api_key = cfg.pinecone_api_key pinecone_region = cfg.pinecone_region pinecone.init(api_key=pinecone_api_key, environment=pinecone_region) - dimension = 1536 + dimension = 1536 if cfg.memory_embeder == "ada" else 768 metric = "cosine" pod_type = "p1" table_name = "auto-gpt" @@ -33,7 +32,7 @@ class PineconeMemory(MemoryProviderSingleton): self.index = pinecone.Index(table_name) def add(self, data): - vector = get_ada_embedding(data) + vector = get_embedding(data) # no metadata here. We may wish to change that long term. resp = self.index.upsert([(str(self.vec_num), vector, {"raw_text": data})]) _text = f"Inserting data into memory at index: {self.vec_num}:\n data: {data}" @@ -53,7 +52,7 @@ class PineconeMemory(MemoryProviderSingleton): :param data: The data to compare to. :param num_relevant: The number of relevant data to return. Defaults to 5 """ - query_embedding = get_ada_embedding(data) + query_embedding = get_embedding(data) results = self.index.query(query_embedding, top_k=num_relevant, include_metadata=True) sorted_results = sorted(results.matches, key=lambda x: x.score) return [str(item['metadata']["raw_text"]) for item in sorted_results] diff --git a/scripts/memory/redismem.py b/scripts/memory/redismem.py index 49045dd8..8f325835 100644 --- a/scripts/memory/redismem.py +++ b/scripts/memory/redismem.py @@ -6,10 +6,14 @@ from redis.commands.search.query import Query from redis.commands.search.indexDefinition import IndexDefinition, IndexType import numpy as np -from memory.base import MemoryProviderSingleton, get_ada_embedding +from memory.base import MemoryProviderSingleton, get_embedding from logger import logger from colorama import Fore, Style +from config import Config +cfg = Config() + +EMBED_DIM = 1536 if cfg.memory_embeder == "ada" else 768 SCHEMA = [ TextField("data"), @@ -18,7 +22,7 @@ SCHEMA = [ "HNSW", { "TYPE": "FLOAT32", - "DIM": 1536, + "DIM": EMBED_DIM, "DISTANCE_METRIC": "COSINE" } ), @@ -38,7 +42,6 @@ class RedisMemory(MemoryProviderSingleton): redis_host = cfg.redis_host redis_port = cfg.redis_port redis_password = cfg.redis_password - self.dimension = 1536 self.redis = redis.Redis( host=redis_host, port=redis_port, @@ -83,7 +86,7 @@ class RedisMemory(MemoryProviderSingleton): """ if 'Command Error:' in data: return "" - vector = get_ada_embedding(data) + vector = get_embedding(data) vector = np.array(vector).astype(np.float32).tobytes() data_dict = { b"data": data, @@ -131,7 +134,7 @@ class RedisMemory(MemoryProviderSingleton): Returns: A list of the most relevant data. """ - query_embedding = get_ada_embedding(data) + query_embedding = get_embedding(data) base_query = f"*=>[KNN {num_relevant} @embedding $vector AS vector_score]" query = Query(base_query).return_fields( "data", From 64db4eef395364def9d5fdac5dce8d9fe60507f6 Mon Sep 17 00:00:00 2001 From: Tymec Date: Fri, 14 Apr 2023 14:47:13 +0200 Subject: [PATCH 04/78] fix: added back numpy to requirements --- requirements.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/requirements.txt b/requirements.txt index 88278435..47534828 100644 --- a/requirements.txt +++ b/requirements.txt @@ -18,3 +18,4 @@ Pillow coverage flake8 sentence_transformers +numpy \ No newline at end of file From b042376db419da8158a0d16e90471c38b58ac2df Mon Sep 17 00:00:00 2001 From: Tymec Date: Fri, 14 Apr 2023 14:53:18 +0200 Subject: [PATCH 05/78] docs: added comments --- scripts/memory/base.py | 2 ++ scripts/memory/local.py | 2 ++ scripts/memory/pinecone.py | 1 + scripts/memory/redismem.py | 2 ++ 4 files changed, 7 insertions(+) diff --git a/scripts/memory/base.py b/scripts/memory/base.py index e3924d7e..a0b3f25f 100644 --- a/scripts/memory/base.py +++ b/scripts/memory/base.py @@ -3,6 +3,7 @@ import abc from config import AbstractSingleton, Config import openai +# try to import sentence transformers, if it fails, default to ada try: from sentence_transformers import SentenceTransformer except ImportError: @@ -18,6 +19,7 @@ cfg = Config() def get_embedding(text): text = text.replace("\n", " ") + # use the embeder specified in the config if cfg.memory_embeder == "sbert": embedding = SentenceTransformer("sentence-transformers/all-mpnet-base-v2", device="cpu").encode(text, show_progress_bar=False) else: diff --git a/scripts/memory/local.py b/scripts/memory/local.py index 40a08f66..728723cb 100644 --- a/scripts/memory/local.py +++ b/scripts/memory/local.py @@ -6,8 +6,10 @@ import os from memory.base import MemoryProviderSingleton, get_embedding from config import Config +# TODO: get the embeddings dimension without importing config cfg = Config() +# set the embedding dimension based on the embeder EMBED_DIM = 1536 if cfg.memory_embeder == "ada" else 768 SAVE_OPTIONS = orjson.OPT_SERIALIZE_NUMPY | orjson.OPT_SERIALIZE_DATACLASS diff --git a/scripts/memory/pinecone.py b/scripts/memory/pinecone.py index b3aab33a..e8a71316 100644 --- a/scripts/memory/pinecone.py +++ b/scripts/memory/pinecone.py @@ -10,6 +10,7 @@ class PineconeMemory(MemoryProviderSingleton): pinecone_api_key = cfg.pinecone_api_key pinecone_region = cfg.pinecone_region pinecone.init(api_key=pinecone_api_key, environment=pinecone_region) + # set the embedding dimension based on the embeder dimension = 1536 if cfg.memory_embeder == "ada" else 768 metric = "cosine" pod_type = "p1" diff --git a/scripts/memory/redismem.py b/scripts/memory/redismem.py index 8f325835..3da52827 100644 --- a/scripts/memory/redismem.py +++ b/scripts/memory/redismem.py @@ -11,8 +11,10 @@ from logger import logger from colorama import Fore, Style from config import Config +# TODO: get the embeddings dimension without importing config cfg = Config() +# set the embedding dimension based on the embeder EMBED_DIM = 1536 if cfg.memory_embeder == "ada" else 768 SCHEMA = [ From fb6684450c2dedba12c598642def45e4df006b62 Mon Sep 17 00:00:00 2001 From: Tymec Date: Fri, 14 Apr 2023 14:56:58 +0200 Subject: [PATCH 06/78] test: added tests for memory embeder --- tests/embeder_test.py | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) create mode 100644 tests/embeder_test.py diff --git a/tests/embeder_test.py b/tests/embeder_test.py new file mode 100644 index 00000000..214b9110 --- /dev/null +++ b/tests/embeder_test.py @@ -0,0 +1,33 @@ +import os +import sys +# Probably a better way: +sys.path.append(os.path.abspath('../scripts')) +from memory.base import get_embedding + +def MockConfig(): + return type('MockConfig', (object,), { + 'debug_mode': False, + 'continuous_mode': False, + 'speak_mode': False, + 'memory_embeder': 'sbert' + }) + +class TestMemoryEmbeder(unittest.TestCase): + def setUp(self): + self.cfg = MockConfig() + + def test_ada(self): + self.cfg.memory_embeder = "ada" + text = "Sample text" + result = get_embedding(text) + self.assertEqual(result.shape, (1536,)) + + def test_sbert(self): + self.cfg.memory_embeder = "sbert" + text = "Sample text" + result = get_embedding(text) + self.assertEqual(result.shape, (768,)) + + +if __name__ == '__main__': + unittest.main() \ No newline at end of file From 653904a3591cc47a099249203c088926ef66cf40 Mon Sep 17 00:00:00 2001 From: Tymec Date: Fri, 14 Apr 2023 15:07:13 +0200 Subject: [PATCH 07/78] chore: added memory embeder option to dotenv template --- .env.template | 2 ++ 1 file changed, 2 insertions(+) diff --git a/.env.template b/.env.template index 474b2727..3ddb6660 100644 --- a/.env.template +++ b/.env.template @@ -50,6 +50,8 @@ SMART_TOKEN_LIMIT=8000 # MEMORY_BACKEND - Memory backend type (Default: local) MEMORY_BACKEND=local +# MEMORY_EMBEDER - Embeddings model to use (Default: ada) +MEMORY_EMBEDER=ada ### PINECONE # PINECONE_API_KEY - Pinecone API Key (Example: my-pinecone-api-key) From 121f4e606c5080b87fec384d07e1b104f00456a4 Mon Sep 17 00:00:00 2001 From: Tymec Date: Fri, 14 Apr 2023 17:17:10 +0200 Subject: [PATCH 08/78] fix: more modular approach for embedding dimension --- scripts/memory/base.py | 6 ++++++ scripts/memory/local.py | 7 +------ scripts/memory/pinecone.py | 6 ++---- scripts/memory/redismem.py | 9 +-------- 4 files changed, 10 insertions(+), 18 deletions(-) diff --git a/scripts/memory/base.py b/scripts/memory/base.py index a0b3f25f..c3fec628 100644 --- a/scripts/memory/base.py +++ b/scripts/memory/base.py @@ -15,6 +15,12 @@ except ImportError: cfg = Config() +# Dimension of embeddings encoded by models +EMBED_DIM = { + "ada": 1536, + "sbert": 768 +}.get(cfg.memory_embeder, default=1536) + def get_embedding(text): text = text.replace("\n", " ") diff --git a/scripts/memory/local.py b/scripts/memory/local.py index 728723cb..e699a891 100644 --- a/scripts/memory/local.py +++ b/scripts/memory/local.py @@ -3,14 +3,9 @@ import orjson from typing import Any, List, Optional import numpy as np import os -from memory.base import MemoryProviderSingleton, get_embedding -from config import Config +from memory.base import MemoryProviderSingleton, get_embedding, EMBED_DIM -# TODO: get the embeddings dimension without importing config -cfg = Config() -# set the embedding dimension based on the embeder -EMBED_DIM = 1536 if cfg.memory_embeder == "ada" else 768 SAVE_OPTIONS = orjson.OPT_SERIALIZE_NUMPY | orjson.OPT_SERIALIZE_DATACLASS diff --git a/scripts/memory/pinecone.py b/scripts/memory/pinecone.py index e8a71316..1f95bb23 100644 --- a/scripts/memory/pinecone.py +++ b/scripts/memory/pinecone.py @@ -1,7 +1,7 @@ import pinecone -from memory.base import MemoryProviderSingleton, get_embedding +from memory.base import MemoryProviderSingleton, get_embedding, EMBED_DIM from logger import logger from colorama import Fore, Style @@ -10,8 +10,6 @@ class PineconeMemory(MemoryProviderSingleton): pinecone_api_key = cfg.pinecone_api_key pinecone_region = cfg.pinecone_region pinecone.init(api_key=pinecone_api_key, environment=pinecone_region) - # set the embedding dimension based on the embeder - dimension = 1536 if cfg.memory_embeder == "ada" else 768 metric = "cosine" pod_type = "p1" table_name = "auto-gpt" @@ -29,7 +27,7 @@ class PineconeMemory(MemoryProviderSingleton): exit(1) if table_name not in pinecone.list_indexes(): - pinecone.create_index(table_name, dimension=dimension, metric=metric, pod_type=pod_type) + pinecone.create_index(table_name, dimension=EMBED_DIM, metric=metric, pod_type=pod_type) self.index = pinecone.Index(table_name) def add(self, data): diff --git a/scripts/memory/redismem.py b/scripts/memory/redismem.py index 3da52827..43e8a33b 100644 --- a/scripts/memory/redismem.py +++ b/scripts/memory/redismem.py @@ -6,16 +6,9 @@ from redis.commands.search.query import Query from redis.commands.search.indexDefinition import IndexDefinition, IndexType import numpy as np -from memory.base import MemoryProviderSingleton, get_embedding +from memory.base import MemoryProviderSingleton, get_embedding, EMBED_DIM from logger import logger from colorama import Fore, Style -from config import Config - -# TODO: get the embeddings dimension without importing config -cfg = Config() - -# set the embedding dimension based on the embeder -EMBED_DIM = 1536 if cfg.memory_embeder == "ada" else 768 SCHEMA = [ TextField("data"), From 2a147acd3f32882b0069e72df7730abb3f7282f8 Mon Sep 17 00:00:00 2001 From: Tymec Date: Fri, 14 Apr 2023 17:58:29 +0200 Subject: [PATCH 09/78] refactor: fix typo Changed all occurrences of "embeder" to "embedder". --- .env.template | 4 ++-- scripts/config.py | 2 +- scripts/memory/base.py | 14 +++++++------- 3 files changed, 10 insertions(+), 10 deletions(-) diff --git a/.env.template b/.env.template index 3ddb6660..f8e46894 100644 --- a/.env.template +++ b/.env.template @@ -50,8 +50,8 @@ SMART_TOKEN_LIMIT=8000 # MEMORY_BACKEND - Memory backend type (Default: local) MEMORY_BACKEND=local -# MEMORY_EMBEDER - Embeddings model to use (Default: ada) -MEMORY_EMBEDER=ada +# MEMORY_EMBEDDER - Embeddings model to use (Default: ada) +MEMORY_EMBEDDER=ada ### PINECONE # PINECONE_API_KEY - Pinecone API Key (Example: my-pinecone-api-key) diff --git a/scripts/config.py b/scripts/config.py index 38cbd142..fbba5a75 100644 --- a/scripts/config.py +++ b/scripts/config.py @@ -82,7 +82,7 @@ class Config(metaclass=Singleton): # Note that indexes must be created on db 0 in redis, this is not configurable. self.memory_backend = os.getenv("MEMORY_BACKEND", 'local') - self.memory_embeder = os.getenv("MEMORY_EMBEDER", 'ada') + self.memory_embedder = os.getenv("MEMORY_EMBEDDER", 'ada') # Initialize the OpenAI API client openai.api_key = self.openai_api_key diff --git a/scripts/memory/base.py b/scripts/memory/base.py index c3fec628..c1b48d3e 100644 --- a/scripts/memory/base.py +++ b/scripts/memory/base.py @@ -8,25 +8,25 @@ try: from sentence_transformers import SentenceTransformer except ImportError: SentenceTransformer = None - if cfg.memory_embeder == "sbert": + if cfg.memory_embedder == "sbert": print("Error: Sentence Transformers is not installed. Please install sentence_transformers" - " to use BERT as an embeder. Defaulting to Ada.") - cfg.memory_embeder = "ada" + " to use sBERT as an embedder. Defaulting to Ada.") + cfg.memory_embedder = "ada" cfg = Config() -# Dimension of embeddings encoded by models +# Dimension of embeddings encoded by embedders EMBED_DIM = { "ada": 1536, "sbert": 768 -}.get(cfg.memory_embeder, default=1536) +}.get(cfg.memory_embedder, default=1536) def get_embedding(text): text = text.replace("\n", " ") - # use the embeder specified in the config - if cfg.memory_embeder == "sbert": + # use the embedder specified in the config + if cfg.memory_embedder == "sbert": embedding = SentenceTransformer("sentence-transformers/all-mpnet-base-v2", device="cpu").encode(text, show_progress_bar=False) else: embedding = openai.Embedding.create(input=[text], model="text-embedding-ada-002")["data"][0]["embedding"] From 34eac5754c2d9dfba18b9b89407400ce2da19e71 Mon Sep 17 00:00:00 2001 From: Tymec Date: Fri, 14 Apr 2023 18:06:47 +0200 Subject: [PATCH 10/78] test: fix typo and add newline at the end - Fixed "embeder" typo to "embedder" - Added newline at the end of test unit --- tests/{embeder_test.py => embedder_test.py} | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) rename tests/{embeder_test.py => embedder_test.py} (75%) diff --git a/tests/embeder_test.py b/tests/embedder_test.py similarity index 75% rename from tests/embeder_test.py rename to tests/embedder_test.py index 214b9110..d64dae11 100644 --- a/tests/embeder_test.py +++ b/tests/embedder_test.py @@ -9,25 +9,26 @@ def MockConfig(): 'debug_mode': False, 'continuous_mode': False, 'speak_mode': False, - 'memory_embeder': 'sbert' + 'memory_embedder': 'sbert' }) -class TestMemoryEmbeder(unittest.TestCase): - def setUp(self): +class TestMemoryEmbedder(unittest.TestCase): + def setUp(self): self.cfg = MockConfig() def test_ada(self): - self.cfg.memory_embeder = "ada" + self.cfg.memory_embedder = "ada" text = "Sample text" result = get_embedding(text) self.assertEqual(result.shape, (1536,)) def test_sbert(self): - self.cfg.memory_embeder = "sbert" + self.cfg.memory_embedder = "sbert" text = "Sample text" result = get_embedding(text) self.assertEqual(result.shape, (768,)) if __name__ == '__main__': - unittest.main() \ No newline at end of file + unittest.main() + \ No newline at end of file From d0dd107f3940ba5b9b41b2ed1d9433956a2ac90c Mon Sep 17 00:00:00 2001 From: Jedakiah Date: Fri, 14 Apr 2023 20:00:36 +0200 Subject: [PATCH 11/78] Fixed error when google results might have weird characters --- scripts/commands.py | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/scripts/commands.py b/scripts/commands.py index fe6f6c30..15e4b2e3 100644 --- a/scripts/commands.py +++ b/scripts/commands.py @@ -61,9 +61,12 @@ def execute_command(command_name, arguments): # Check if the Google API key is set and use the official search method # If the API key is not set or has only whitespaces, use the unofficial search method if cfg.google_api_key and (cfg.google_api_key.strip() if cfg.google_api_key else None): - return google_official_search(arguments["input"]) + google_result = google_official_search(arguments["input"]) else: - return google_search(arguments["input"]) + google_result = google_search(arguments["input"]) + + safe_message = google_result.encode('utf-8', 'ignore') + return str(safe_message) elif command_name == "memory_add": return memory.add(arguments["string"]) elif command_name == "start_agent": From 359c3bc06700ecff77734b1348f523b975c59c4d Mon Sep 17 00:00:00 2001 From: Merwane Hamadi Date: Fri, 14 Apr 2023 12:27:04 -0700 Subject: [PATCH 12/78] make 0 the default temperature --- .env.template | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.env.template b/.env.template index 22bf8d74..a8bb246e 100644 --- a/.env.template +++ b/.env.template @@ -21,7 +21,7 @@ AI_SETTINGS_FILE=ai_settings.yaml # TEMPERATURE - Sets temperature in OpenAI (Default: 1) # USE_AZURE - Use Azure OpenAI or not (Default: False) OPENAI_API_KEY=your-openai-api-key -TEMPERATURE=1 +TEMPERATURE=0 USE_AZURE=False ### AZURE From 091457a24f7c85a8c961420f1b8fa1b80fd724c1 Mon Sep 17 00:00:00 2001 From: Tymec Date: Fri, 14 Apr 2023 22:48:25 +0200 Subject: [PATCH 13/78] fix: removed keyword default from dict.get arguments --- scripts/memory/base.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scripts/memory/base.py b/scripts/memory/base.py index c1b48d3e..1f13f38b 100644 --- a/scripts/memory/base.py +++ b/scripts/memory/base.py @@ -19,7 +19,7 @@ cfg = Config() EMBED_DIM = { "ada": 1536, "sbert": 768 -}.get(cfg.memory_embedder, default=1536) +}.get(cfg.memory_embedder, 1536) def get_embedding(text): From 062176d3f5ac57c83148fe5595b72c93a4a4d95c Mon Sep 17 00:00:00 2001 From: Tymec Date: Fri, 14 Apr 2023 22:49:13 +0200 Subject: [PATCH 14/78] test: replaced MockConfig with real config get_embedding function uses config --- tests/embedder_test.py | 25 ++++++++++--------------- 1 file changed, 10 insertions(+), 15 deletions(-) diff --git a/tests/embedder_test.py b/tests/embedder_test.py index d64dae11..fddcf225 100644 --- a/tests/embedder_test.py +++ b/tests/embedder_test.py @@ -3,32 +3,27 @@ import sys # Probably a better way: sys.path.append(os.path.abspath('../scripts')) from memory.base import get_embedding +from config import Config +import unittest + + +# Required, because the get_embedding function uses it +cfg = Config() -def MockConfig(): - return type('MockConfig', (object,), { - 'debug_mode': False, - 'continuous_mode': False, - 'speak_mode': False, - 'memory_embedder': 'sbert' - }) class TestMemoryEmbedder(unittest.TestCase): - def setUp(self): - self.cfg = MockConfig() - def test_ada(self): - self.cfg.memory_embedder = "ada" + cfg.memory_embedder = "ada" text = "Sample text" result = get_embedding(text) - self.assertEqual(result.shape, (1536,)) + self.assertEqual(len(result), 1536) def test_sbert(self): - self.cfg.memory_embedder = "sbert" + cfg.memory_embedder = "sbert" text = "Sample text" result = get_embedding(text) - self.assertEqual(result.shape, (768,)) + self.assertEqual(len(result), 768) if __name__ == '__main__': unittest.main() - \ No newline at end of file From 7e21123a5d11ac7ffe30f2434bea47d76a4c1f48 Mon Sep 17 00:00:00 2001 From: Merwane Hamadi Date: Wed, 12 Apr 2023 14:50:45 -0700 Subject: [PATCH 15/78] Add README.md with instructions on running tests --- tests/README.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 tests/README.md diff --git a/tests/README.md b/tests/README.md new file mode 100644 index 00000000..54cc1117 --- /dev/null +++ b/tests/README.md @@ -0,0 +1,17 @@ +For now there aren't many tests. +So just run: + +``` +python tests/unit/json_tests.py +python tests/integration/memory_tests.py +``` + +paid test: +``` +python tests/integration/test_commands.py +``` +This test costs 0.004$ per run with GPT-3.5. We will setup a pipeline in github action to allow people to run these tests for free. + +The pipeline will be be triggered for now. + +TODO: when we setup pytest, replace lines above by: pytest commands From 36091853e0a649e2b268a21f3fa6d43cf837eb23 Mon Sep 17 00:00:00 2001 From: Merwane Hamadi Date: Wed, 12 Apr 2023 14:50:45 -0700 Subject: [PATCH 16/78] Add integration test for write_file command --- tests/integration/test_commands.py | 68 ++++++++++++++++++++++++++++++ 1 file changed, 68 insertions(+) create mode 100644 tests/integration/test_commands.py diff --git a/tests/integration/test_commands.py b/tests/integration/test_commands.py new file mode 100644 index 00000000..0a053eef --- /dev/null +++ b/tests/integration/test_commands.py @@ -0,0 +1,68 @@ +import contextlib +import os +import subprocess +import sys +import time +from pathlib import Path +import unittest +import platform + +# Import necessary modules for testing, file operations, and handling system paths. + +root_path = Path(__file__).resolve().parent.parent.parent +sys.path.append(str(root_path / 'scripts')) +from file_operations import read_file +from file_operations import delete_file + +env_vars = { + 'MEMORY_BACKEND': 'no_memory', + 'TEMPERATURE': "0" +} + +# Set environment variables for the test. + +class TestCommands(unittest.TestCase): + def test_write_file(self): + # Test case to check if the write_file command can successfully write 'Hello World' to a file named 'hello_world.txt'. + + # Read the current ai_settings.yaml file and store its content. + with open('ai_settings.yaml', 'r') as f: + ai_settings = f.read() + + try: + with contextlib.suppress(Exception): + # Clean up any existing 'hello_world.txt' file before testing. + delete_file('hello_world.txt') + + # Remove ai_settings.yaml file to avoid continuing from the previous session. + os.remove('ai_settings.yaml') + + # Prepare input data for the test. + input_data = '''write_file-GPT +an AI designed to use the write_file command to write 'Hello World' into a file named "hello_world.txt" and then use the task_complete command to complete the task. +Use the write_file command to write 'Hello World' into a file named "hello_world.txt". +Use the task_complete command to complete the task. +Do not use any other commands. + +y -5 +EOF''' + script_path = root_path / 'scripts' / 'main.py' + command = f'{sys.executable} {script_path}' + + # Execute the script with the input data. + process = subprocess.Popen(command, stdin=subprocess.PIPE, shell=True, env={**os.environ, **env_vars}) + process.communicate(input_data.encode()) + + # Read the content of the 'hello_world.txt' file created during the test. + content = read_file('hello_world.txt') + finally: + # Restore the original ai_settings.yaml file. + with open('ai_settings.yaml', 'w') as f: + f.write(ai_settings) + + # Check if the content of the 'hello_world.txt' file is equal to 'Hello World'. + self.assertEqual(content, 'Hello World', f"Expected 'Hello World', got {content}") + +# Run the test case. +if __name__ == '__main__': + unittest.main() From ca5a52f48ab10f2ec3ab698c222c796fbde143b0 Mon Sep 17 00:00:00 2001 From: Merwane Hamadi Date: Wed, 12 Apr 2023 14:50:45 -0700 Subject: [PATCH 17/78] Update sys.path to use pathlib in json_tests.py --- tests/integration/test_commands.py | 19 ++++++++++++------- tests/unit/json_tests.py | 10 ++++++++++ 2 files changed, 22 insertions(+), 7 deletions(-) diff --git a/tests/integration/test_commands.py b/tests/integration/test_commands.py index 0a053eef..26413437 100644 --- a/tests/integration/test_commands.py +++ b/tests/integration/test_commands.py @@ -19,15 +19,18 @@ env_vars = { 'TEMPERATURE': "0" } -# Set environment variables for the test. class TestCommands(unittest.TestCase): + def test_write_file(self): - # Test case to check if the write_file command can successfully write 'Hello World' to a file named 'hello_world.txt'. + # Test case to check if the write_file command can successfully write 'Hello World' to a file + # named 'hello_world.txt'. # Read the current ai_settings.yaml file and store its content. - with open('ai_settings.yaml', 'r') as f: - ai_settings = f.read() + ai_settings = None + with contextlib.suppress(Exception): + with open('ai_settings.yaml', 'r') as f: + ai_settings = f.read() try: with contextlib.suppress(Exception): @@ -56,13 +59,15 @@ EOF''' # Read the content of the 'hello_world.txt' file created during the test. content = read_file('hello_world.txt') finally: - # Restore the original ai_settings.yaml file. - with open('ai_settings.yaml', 'w') as f: - f.write(ai_settings) + if ai_settings: + # Restore the original ai_settings.yaml file. + with open('ai_settings.yaml', 'w') as f: + f.write(ai_settings) # Check if the content of the 'hello_world.txt' file is equal to 'Hello World'. self.assertEqual(content, 'Hello World', f"Expected 'Hello World', got {content}") + # Run the test case. if __name__ == '__main__': unittest.main() diff --git a/tests/unit/json_tests.py b/tests/unit/json_tests.py index 561b8a38..4899f265 100644 --- a/tests/unit/json_tests.py +++ b/tests/unit/json_tests.py @@ -1,6 +1,16 @@ import unittest +<<<<<<< HEAD from autogpt.json_parser import fix_and_parse_json +======= +import os +import sys +from pathlib import Path + +# Probably a better way: +sys.path.append(str(Path(__file__).resolve().parent.parent.parent / 'scripts')) +from json_parser import fix_and_parse_json +>>>>>>> 27e0703d (Update sys.path to use pathlib in json_tests.py) class TestParseJson(unittest.TestCase): From 6c9ec3219530997610fecaf77ebc7b6733cc16ea Mon Sep 17 00:00:00 2001 From: Tymec Date: Sat, 15 Apr 2023 01:34:51 +0200 Subject: [PATCH 18/78] test: fixed imports --- tests/embedder_test.py | 7 ++----- 1 file changed, 2 insertions(+), 5 deletions(-) diff --git a/tests/embedder_test.py b/tests/embedder_test.py index fddcf225..5b9ca798 100644 --- a/tests/embedder_test.py +++ b/tests/embedder_test.py @@ -1,11 +1,8 @@ import os import sys -# Probably a better way: -sys.path.append(os.path.abspath('../scripts')) -from memory.base import get_embedding -from config import Config -import unittest +from autogpt.config import Config +from autogpt.memory.base import get_embedding # Required, because the get_embedding function uses it cfg = Config() From dc4094b2646ad4330bef23331f75fd15f4cdb9a0 Mon Sep 17 00:00:00 2001 From: Merwane Hamadi Date: Fri, 14 Apr 2023 16:47:14 -0700 Subject: [PATCH 19/78] added smoke test --- .gitignore | 5 +++- tests/README.md | 17 -------------- .../test_commands.py => smoke_test.py} | 23 ++++--------------- tests/unit/json_tests.py | 10 -------- 4 files changed, 9 insertions(+), 46 deletions(-) delete mode 100644 tests/README.md rename tests/{integration/test_commands.py => smoke_test.py} (73%) diff --git a/.gitignore b/.gitignore index 9874d425..91d932d8 100644 --- a/.gitignore +++ b/.gitignore @@ -151,4 +151,7 @@ dmypy.json # Pyre type checker .pyre/ llama-* -vicuna-* \ No newline at end of file +vicuna-* + +# mac +.DS_Store diff --git a/tests/README.md b/tests/README.md deleted file mode 100644 index 54cc1117..00000000 --- a/tests/README.md +++ /dev/null @@ -1,17 +0,0 @@ -For now there aren't many tests. -So just run: - -``` -python tests/unit/json_tests.py -python tests/integration/memory_tests.py -``` - -paid test: -``` -python tests/integration/test_commands.py -``` -This test costs 0.004$ per run with GPT-3.5. We will setup a pipeline in github action to allow people to run these tests for free. - -The pipeline will be be triggered for now. - -TODO: when we setup pytest, replace lines above by: pytest commands diff --git a/tests/integration/test_commands.py b/tests/smoke_test.py similarity index 73% rename from tests/integration/test_commands.py rename to tests/smoke_test.py index 26413437..1f0f24f9 100644 --- a/tests/integration/test_commands.py +++ b/tests/smoke_test.py @@ -1,18 +1,9 @@ -import contextlib import os import subprocess import sys -import time -from pathlib import Path import unittest -import platform -# Import necessary modules for testing, file operations, and handling system paths. - -root_path = Path(__file__).resolve().parent.parent.parent -sys.path.append(str(root_path / 'scripts')) -from file_operations import read_file -from file_operations import delete_file +from autogpt.file_operations import delete_file, read_file env_vars = { 'MEMORY_BACKEND': 'no_memory', @@ -28,18 +19,15 @@ class TestCommands(unittest.TestCase): # Read the current ai_settings.yaml file and store its content. ai_settings = None - with contextlib.suppress(Exception): + if os.path.exists('ai_settings.yaml'): with open('ai_settings.yaml', 'r') as f: ai_settings = f.read() + os.remove('ai_settings.yaml') try: - with contextlib.suppress(Exception): + if os.path.exists('hello_world.txt'): # Clean up any existing 'hello_world.txt' file before testing. delete_file('hello_world.txt') - - # Remove ai_settings.yaml file to avoid continuing from the previous session. - os.remove('ai_settings.yaml') - # Prepare input data for the test. input_data = '''write_file-GPT an AI designed to use the write_file command to write 'Hello World' into a file named "hello_world.txt" and then use the task_complete command to complete the task. @@ -49,8 +37,7 @@ Do not use any other commands. y -5 EOF''' - script_path = root_path / 'scripts' / 'main.py' - command = f'{sys.executable} {script_path}' + command = f'{sys.executable} -m autogpt' # Execute the script with the input data. process = subprocess.Popen(command, stdin=subprocess.PIPE, shell=True, env={**os.environ, **env_vars}) diff --git a/tests/unit/json_tests.py b/tests/unit/json_tests.py index 4899f265..561b8a38 100644 --- a/tests/unit/json_tests.py +++ b/tests/unit/json_tests.py @@ -1,16 +1,6 @@ import unittest -<<<<<<< HEAD from autogpt.json_parser import fix_and_parse_json -======= -import os -import sys -from pathlib import Path - -# Probably a better way: -sys.path.append(str(Path(__file__).resolve().parent.parent.parent / 'scripts')) -from json_parser import fix_and_parse_json ->>>>>>> 27e0703d (Update sys.path to use pathlib in json_tests.py) class TestParseJson(unittest.TestCase): From bac898f9934fb1766869def0246808d9b7ade255 Mon Sep 17 00:00:00 2001 From: Gershon Bialer Date: Fri, 14 Apr 2023 20:59:58 -0700 Subject: [PATCH 20/78] Fix list_agents to not call it self. --- autogpt/commands.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/autogpt/commands.py b/autogpt/commands.py index 352b3340..7301ff68 100644 --- a/autogpt/commands.py +++ b/autogpt/commands.py @@ -265,7 +265,7 @@ def message_agent(key, message): def list_agents(): """List all agents""" - return list_agents() + return agents.list_agents() def delete_agent(key): From 0b4f0f56226a756cdb9dad28ddb4ff25cb499263 Mon Sep 17 00:00:00 2001 From: Gershon Bialer Date: Fri, 14 Apr 2023 21:34:28 -0700 Subject: [PATCH 21/78] Add unit test for testing adding a gent --- tests/unit/test_commands.py | 13 +++++++++++++ 1 file changed, 13 insertions(+) create mode 100644 tests/unit/test_commands.py diff --git a/tests/unit/test_commands.py b/tests/unit/test_commands.py new file mode 100644 index 00000000..b7bddcec --- /dev/null +++ b/tests/unit/test_commands.py @@ -0,0 +1,13 @@ +from autogpt import commands +import unittest +from unittest.mock import patch,MagicMock + +class TestCommands(unittest.TestCase): + def test_make_agent(self): + with patch("openai.ChatCompletion.create") as mock: + obj = MagicMock() + obj.response.choices[0].messages[0].content = "Test message" + mock.return_value = obj + commands.start_agent("Test Agent", "chat", "Hello, how are you?", "gpt2") + agents = commands.list_agents() + self.assertEqual(agents[0], (0,'chat')) \ No newline at end of file From 2644bc86db12cc51b3a2794c4280ceb838753b43 Mon Sep 17 00:00:00 2001 From: Gershon Bialer Date: Fri, 14 Apr 2023 21:42:54 -0700 Subject: [PATCH 22/78] list_agents should return string not JSON --- autogpt/commands.py | 2 +- tests/unit/test_commands.py | 5 ++++- 2 files changed, 5 insertions(+), 2 deletions(-) diff --git a/autogpt/commands.py b/autogpt/commands.py index 7301ff68..122b453e 100644 --- a/autogpt/commands.py +++ b/autogpt/commands.py @@ -265,7 +265,7 @@ def message_agent(key, message): def list_agents(): """List all agents""" - return agents.list_agents() + return "List of agents:\n" + "\n".join([str(x[0]) + ": " + x[1] for x in agents.list_agents()]) def delete_agent(key): diff --git a/tests/unit/test_commands.py b/tests/unit/test_commands.py index b7bddcec..1ecfc517 100644 --- a/tests/unit/test_commands.py +++ b/tests/unit/test_commands.py @@ -10,4 +10,7 @@ class TestCommands(unittest.TestCase): mock.return_value = obj commands.start_agent("Test Agent", "chat", "Hello, how are you?", "gpt2") agents = commands.list_agents() - self.assertEqual(agents[0], (0,'chat')) \ No newline at end of file + self.assertEqual("List of agents:\n0: chat", agents) + commands.start_agent("Test Agent 2", "write", "Hello, how are you?", "gpt2") + agents = commands.list_agents() + self.assertEqual("List of agents:\n0: chat\n1: write", agents) From 9990b78702caabca3fdbb02488dde53eae75df2b Mon Sep 17 00:00:00 2001 From: Gershon Bialer Date: Fri, 14 Apr 2023 22:44:42 -0700 Subject: [PATCH 23/78] Fix linter issues. --- tests/unit/test_commands.py | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/tests/unit/test_commands.py b/tests/unit/test_commands.py index 1ecfc517..9bb4c9c4 100644 --- a/tests/unit/test_commands.py +++ b/tests/unit/test_commands.py @@ -1,6 +1,7 @@ from autogpt import commands import unittest -from unittest.mock import patch,MagicMock +from unittest.mock import patch, MagicMock + class TestCommands(unittest.TestCase): def test_make_agent(self): From 72da564db5b6a0e2c6e98a5b205e5e52c5e47703 Mon Sep 17 00:00:00 2001 From: HDKiller Date: Sat, 15 Apr 2023 06:27:08 +0000 Subject: [PATCH 24/78] remove "please" from prompt for summarizing text --- autogpt/summary.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/autogpt/summary.py b/autogpt/summary.py index 38f0aadc..6daa6976 100644 --- a/autogpt/summary.py +++ b/autogpt/summary.py @@ -57,9 +57,9 @@ def split_text(text, max_length=8192): def create_message(chunk, question): return { "role": "user", - "content": f'"""{chunk}""" Using the above text, please answer the following' + "content": f'"""{chunk}""" Using the above text, answer the following' f' question: "{question}" -- if the question cannot be answered using the text,' - " please summarize the text.", + " summarize the text.", } From bee1bc8c06f2a2abfe77a266de094ee1728f5595 Mon Sep 17 00:00:00 2001 From: HDKiller Date: Sat, 15 Apr 2023 06:28:14 +0000 Subject: [PATCH 25/78] remove "please" from prompt in browser.py --- autogpt/browse.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/autogpt/browse.py b/autogpt/browse.py index 60d33744..00ec7ec3 100644 --- a/autogpt/browse.py +++ b/autogpt/browse.py @@ -145,9 +145,9 @@ def create_message(chunk, question): """Create a message for the user to summarize a chunk of text""" return { "role": "user", - "content": f'"""{chunk}""" Using the above text, please answer the following' + "content": f'"""{chunk}""" Using the above text, answer the following' f' question: "{question}" -- if the question cannot be answered using the' - " text, please summarize the text.", + " text, summarize the text.", } From b2d6987cac396960327bc7ec4120a0cd83eb44a6 Mon Sep 17 00:00:00 2001 From: Jacob Hahn Date: Sat, 15 Apr 2023 04:17:00 -0400 Subject: [PATCH 26/78] Fixed condition where key could be string --- autogpt/commands.py | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/autogpt/commands.py b/autogpt/commands.py index 352b3340..8f873606 100644 --- a/autogpt/commands.py +++ b/autogpt/commands.py @@ -251,11 +251,8 @@ def message_agent(key, message): # Check if the key is a valid integer if is_valid_int(key): agent_response = agents.message_agent(int(key), message) - # Check if the key is a valid string - elif isinstance(key, str): - agent_response = agents.message_agent(key, message) else: - return "Invalid key, must be an integer or a string." + return "Invalid key, must be an integer." # Speak response if cfg.speak_mode: From d53bd020ea7244a0246d900640f1ab377224384e Mon Sep 17 00:00:00 2001 From: Duncan Roosma Date: Sat, 15 Apr 2023 11:42:12 +0200 Subject: [PATCH 27/78] Update docker-compose.yml Needed to add this to get `docker-compose run auto-gpt` to run successfully --- docker-compose.yml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docker-compose.yml b/docker-compose.yml index 79f20bb5..be225d7d 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -7,6 +7,8 @@ services: depends_on: - redis build: ./ + env_file: + - .env volumes: - "./autogpt:/app" - ".env:/app/.env" From a40f33546449b3944f7dc924a6a4dfe31ae2a358 Mon Sep 17 00:00:00 2001 From: Shai Perednik Date: Sat, 15 Apr 2023 05:58:04 -0400 Subject: [PATCH 28/78] typo in TOC MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit the new memory seeiding url was wrong - [๐Ÿง  Memory pre-seeding](#-memory-pre-seeding) --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 55c3d833..51b62c12 100644 --- a/README.md +++ b/README.md @@ -50,7 +50,7 @@ Your support is greatly appreciated - [Setting up environment variables](#setting-up-environment-variables-1) - [Setting Your Cache Type](#setting-your-cache-type) - [View Memory Usage](#view-memory-usage) - - [๐Ÿง  Memory pre-seeding](#memory-pre-seeding) + - [๐Ÿง  Memory pre-seeding](#-memory-pre-seeding) - [๐Ÿ’€ Continuous Mode โš ๏ธ](#-continuous-mode-๏ธ) - [GPT3.5 ONLY Mode](#gpt35-only-mode) - [๐Ÿ–ผ Image Generation](#-image-generation) From c69050fc84e1dc0484da28204d350ab0bdf7f3c5 Mon Sep 17 00:00:00 2001 From: Pietro Monticone <38562595+pitmonticone@users.noreply.github.com> Date: Sat, 15 Apr 2023 14:05:23 +0200 Subject: [PATCH 29/78] Fix typo --- README.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 55c3d833..6b5dc7d4 100644 --- a/README.md +++ b/README.md @@ -35,13 +35,16 @@ Your support is greatly appreciated ## Table of Contents - [Auto-GPT: An Autonomous GPT-4 Experiment](#auto-gpt-an-autonomous-gpt-4-experiment) - - [Demo (30/03/2023):](#demo-30032023) + - [๐Ÿ”ด ๐Ÿ”ด ๐Ÿ”ด Urgent: USE `stable` not `master` ๐Ÿ”ด ๐Ÿ”ด ๐Ÿ”ด](#----urgent-use-stable-not-master----) + - [Demo (30/03/2023):](#demo-30032023) - [Table of Contents](#table-of-contents) - [๐Ÿš€ Features](#-features) - [๐Ÿ“‹ Requirements](#-requirements) - [๐Ÿ’พ Installation](#-installation) - [๐Ÿ”ง Usage](#-usage) - [Logs](#logs) + - [Docker](#docker) + - [Command Line Arguments](#command-line-arguments) - [๐Ÿ—ฃ๏ธ Speech Mode](#๏ธ-speech-mode) - [๐Ÿ” Google API Keys Configuration](#-google-api-keys-configuration) - [Setting up environment variables](#setting-up-environment-variables) @@ -50,7 +53,7 @@ Your support is greatly appreciated - [Setting up environment variables](#setting-up-environment-variables-1) - [Setting Your Cache Type](#setting-your-cache-type) - [View Memory Usage](#view-memory-usage) - - [๐Ÿง  Memory pre-seeding](#memory-pre-seeding) + - [๐Ÿง  Memory pre-seeding](#-memory-pre-seeding) - [๐Ÿ’€ Continuous Mode โš ๏ธ](#-continuous-mode-๏ธ) - [GPT3.5 ONLY Mode](#gpt35-only-mode) - [๐Ÿ–ผ Image Generation](#-image-generation) @@ -333,7 +336,7 @@ Memories will be available to the AI immediately as they are ingested, even if i In the example above, the script initializes the memory, ingests all files within the seed_data directory into memory with an overlap between chunks of 200 and a maximum length of each chunk of 4000. Note that you can also use the --file argument to ingest a single file into memory and that the script will only ingest files within the auto_gpt_workspace directory. -You can adjust the max_length and overlap parameters to fine-tune the way the docuents are presented to the AI when it "recall" that memory: +You can adjust the max_length and overlap parameters to fine-tune the way the documents are presented to the AI when it "recall" that memory: - Adjusting the overlap value allows the AI to access more contextual information from each chunk when recalling information, but will result in more chunks being created and therefore increase memory backend usage and OpenAI API requests. - Reducing the max_length value will create more chunks, which can save prompt tokens by allowing for more message history in the context, but will also increase the number of chunks. From cc7d421c7743542e53b73e01208d346f26c11222 Mon Sep 17 00:00:00 2001 From: Pietro Monticone <38562595+pitmonticone@users.noreply.github.com> Date: Sat, 15 Apr 2023 14:07:39 +0200 Subject: [PATCH 30/78] Update README.md --- README.md | 7 ++----- 1 file changed, 2 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 6b5dc7d4..1381e957 100644 --- a/README.md +++ b/README.md @@ -35,16 +35,13 @@ Your support is greatly appreciated ## Table of Contents - [Auto-GPT: An Autonomous GPT-4 Experiment](#auto-gpt-an-autonomous-gpt-4-experiment) - - [๐Ÿ”ด ๐Ÿ”ด ๐Ÿ”ด Urgent: USE `stable` not `master` ๐Ÿ”ด ๐Ÿ”ด ๐Ÿ”ด](#----urgent-use-stable-not-master----) - - [Demo (30/03/2023):](#demo-30032023) + - [Demo (30/03/2023):](#demo-30032023) - [Table of Contents](#table-of-contents) - [๐Ÿš€ Features](#-features) - [๐Ÿ“‹ Requirements](#-requirements) - [๐Ÿ’พ Installation](#-installation) - [๐Ÿ”ง Usage](#-usage) - [Logs](#logs) - - [Docker](#docker) - - [Command Line Arguments](#command-line-arguments) - [๐Ÿ—ฃ๏ธ Speech Mode](#๏ธ-speech-mode) - [๐Ÿ” Google API Keys Configuration](#-google-api-keys-configuration) - [Setting up environment variables](#setting-up-environment-variables) @@ -53,7 +50,7 @@ Your support is greatly appreciated - [Setting up environment variables](#setting-up-environment-variables-1) - [Setting Your Cache Type](#setting-your-cache-type) - [View Memory Usage](#view-memory-usage) - - [๐Ÿง  Memory pre-seeding](#-memory-pre-seeding) + - [๐Ÿง  Memory pre-seeding](#memory-pre-seeding) - [๐Ÿ’€ Continuous Mode โš ๏ธ](#-continuous-mode-๏ธ) - [GPT3.5 ONLY Mode](#gpt35-only-mode) - [๐Ÿ–ผ Image Generation](#-image-generation) From 1073954fb74578cb392ca19a2887bea8c984c06f Mon Sep 17 00:00:00 2001 From: BillSchumacher <34168009+BillSchumacher@users.noreply.github.com> Date: Sat, 15 Apr 2023 07:56:23 -0500 Subject: [PATCH 31/78] Reorg (#1537) * Pi's message. * Fix most everything. * Blacked * Add Typing, Docstrings everywhere, organize the code a bit. * Black * fix import * Update message, dedupe. * Increase backoff time. * bump up retries --- README.md | 4 + autogpt/__main__.py | 545 +----------------- autogpt/agent/__init__.py | 4 + autogpt/{ => agent}/agent.py | 137 +---- autogpt/agent/agent_manager.py | 100 ++++ autogpt/agent_manager.py | 75 --- autogpt/ai_functions.py | 77 --- autogpt/{commands.py => app.py} | 214 +++---- autogpt/args.py | 128 ++++ autogpt/call_ai_function.py | 26 - autogpt/chat.py | 2 +- autogpt/commands/__init__.py | 0 autogpt/commands/evaluate_code.py | 25 + autogpt/commands/execute_code.py | 125 ++++ autogpt/{ => commands}/file_operations.py | 109 +++- autogpt/commands/google_search.py | 86 +++ autogpt/commands/image_gen.py | 99 ++++ autogpt/commands/improve_code.py | 28 + autogpt/commands/times.py | 10 + .../{browse.py => commands/web_requests.py} | 176 +++--- autogpt/commands/web_selenium.py | 145 +++++ autogpt/commands/write_tests.py | 29 + autogpt/config/__init__.py | 14 + autogpt/{ => config}/ai_config.py | 22 +- autogpt/{ => config}/config.py | 94 +-- autogpt/config/singleton.py | 24 + autogpt/data_ingestion.py | 5 +- autogpt/execute_code.py | 105 ---- autogpt/image_gen.py | 67 --- autogpt/json_fixes/__init__.py | 0 autogpt/json_fixes/auto_fix.py | 40 ++ autogpt/json_fixes/bracket_termination.py | 73 +++ autogpt/json_fixes/escaping.py | 33 ++ autogpt/json_fixes/missing_quotes.py | 27 + autogpt/json_fixes/parsing.py | 143 +++++ autogpt/json_fixes/utilities.py | 20 + autogpt/json_parser.py | 113 ---- autogpt/json_utils.py | 128 ---- autogpt/llm_utils.py | 90 ++- autogpt/{logger.py => logs.py} | 113 +++- autogpt/memory/local.py | 18 +- autogpt/memory/no_memory.py | 5 + autogpt/memory/pinecone.py | 13 +- autogpt/memory/redismem.py | 6 +- autogpt/processing/__init__.py | 0 autogpt/processing/text.py | 132 +++++ autogpt/prompt.py | 47 ++ autogpt/promptgenerator.py | 12 +- autogpt/setup.py | 69 +++ autogpt/speak.py | 120 ---- autogpt/speech/__init__.py | 4 + autogpt/speech/base.py | 50 ++ autogpt/speech/brian.py | 39 ++ autogpt/speech/eleven_labs.py | 71 +++ autogpt/speech/gtts.py | 21 + autogpt/speech/macos_tts.py | 21 + autogpt/speech/say.py | 42 ++ autogpt/spinner.py | 24 +- autogpt/summary.py | 69 --- autogpt/token_counter.py | 19 +- autogpt/web.py | 85 --- scripts/main.py | 11 - tests/test_json_parser.py | 2 +- tests/unit/test_browse_scrape_text.py | 2 +- 64 files changed, 2254 insertions(+), 1883 deletions(-) create mode 100644 autogpt/agent/__init__.py rename autogpt/{ => agent}/agent.py (56%) create mode 100644 autogpt/agent/agent_manager.py delete mode 100644 autogpt/agent_manager.py delete mode 100644 autogpt/ai_functions.py rename autogpt/{commands.py => app.py} (61%) create mode 100644 autogpt/args.py delete mode 100644 autogpt/call_ai_function.py create mode 100644 autogpt/commands/__init__.py create mode 100644 autogpt/commands/evaluate_code.py create mode 100644 autogpt/commands/execute_code.py rename autogpt/{ => commands}/file_operations.py (58%) create mode 100644 autogpt/commands/google_search.py create mode 100644 autogpt/commands/image_gen.py create mode 100644 autogpt/commands/improve_code.py create mode 100644 autogpt/commands/times.py rename autogpt/{browse.py => commands/web_requests.py} (51%) create mode 100644 autogpt/commands/web_selenium.py create mode 100644 autogpt/commands/write_tests.py create mode 100644 autogpt/config/__init__.py rename autogpt/{ => config}/ai_config.py (87%) rename autogpt/{ => config}/config.py (76%) create mode 100644 autogpt/config/singleton.py delete mode 100644 autogpt/execute_code.py delete mode 100644 autogpt/image_gen.py create mode 100644 autogpt/json_fixes/__init__.py create mode 100644 autogpt/json_fixes/auto_fix.py create mode 100644 autogpt/json_fixes/bracket_termination.py create mode 100644 autogpt/json_fixes/escaping.py create mode 100644 autogpt/json_fixes/missing_quotes.py create mode 100644 autogpt/json_fixes/parsing.py create mode 100644 autogpt/json_fixes/utilities.py delete mode 100644 autogpt/json_parser.py delete mode 100644 autogpt/json_utils.py rename autogpt/{logger.py => logs.py} (59%) create mode 100644 autogpt/processing/__init__.py create mode 100644 autogpt/processing/text.py create mode 100644 autogpt/setup.py delete mode 100644 autogpt/speak.py create mode 100644 autogpt/speech/__init__.py create mode 100644 autogpt/speech/base.py create mode 100644 autogpt/speech/brian.py create mode 100644 autogpt/speech/eleven_labs.py create mode 100644 autogpt/speech/gtts.py create mode 100644 autogpt/speech/macos_tts.py create mode 100644 autogpt/speech/say.py delete mode 100644 autogpt/summary.py delete mode 100644 autogpt/web.py delete mode 100644 scripts/main.py diff --git a/README.md b/README.md index 55c3d833..ba421774 100644 --- a/README.md +++ b/README.md @@ -376,6 +376,10 @@ IMAGE_PROVIDER=sd HUGGINGFACE_API_TOKEN="YOUR_HUGGINGFACE_API_TOKEN" ``` +## Selenium + +sudo Xvfb :10 -ac -screen 0 1024x768x24 & +DISPLAY=:10 your-client ## โš ๏ธ Limitations This experiment aims to showcase the potential of GPT-4 but comes with some limitations: diff --git a/autogpt/__main__.py b/autogpt/__main__.py index e7ac6810..f90f1532 100644 --- a/autogpt/__main__.py +++ b/autogpt/__main__.py @@ -1,371 +1,20 @@ -import argparse -import json +"""Main script for the autogpt package.""" import logging -import traceback +from autogpt.agent.agent import Agent +from autogpt.args import parse_arguments -from colorama import Fore, Style +from autogpt.config import Config, check_openai_api_key +from autogpt.logs import logger +from autogpt.memory import get_memory -from autogpt import chat -from autogpt import commands as cmd -from autogpt import speak, utils -from autogpt.ai_config import AIConfig -from autogpt.config import Config -from autogpt.json_parser import fix_and_parse_json -from autogpt.logger import logger -from autogpt.memory import get_memory, get_supported_memory_backends -from autogpt.spinner import Spinner +from autogpt.prompt import construct_prompt -cfg = Config() -config = None +# Load environment variables from .env file -def check_openai_api_key(): - """Check if the OpenAI API key is set in config.py or as an environment variable.""" - if not cfg.openai_api_key: - print( - Fore.RED - + "Please set your OpenAI API key in .env or as an environment variable." - ) - print("You can get your key from https://beta.openai.com/account/api-keys") - exit(1) - - -def attempt_to_fix_json_by_finding_outermost_brackets(json_string): - if cfg.speak_mode and cfg.debug_mode: - speak.say_text( - "I have received an invalid JSON response from the OpenAI API. " - "Trying to fix it now." - ) - logger.typewriter_log("Attempting to fix JSON by finding outermost brackets\n") - - try: - # Use regex to search for JSON objects - import regex - - json_pattern = regex.compile(r"\{(?:[^{}]|(?R))*\}") - json_match = json_pattern.search(json_string) - - if json_match: - # Extract the valid JSON object from the string - json_string = json_match.group(0) - logger.typewriter_log( - title="Apparently json was fixed.", title_color=Fore.GREEN - ) - if cfg.speak_mode and cfg.debug_mode: - speak.say_text("Apparently json was fixed.") - else: - raise ValueError("No valid JSON object found") - - except (json.JSONDecodeError, ValueError) as e: - if cfg.debug_mode: - logger.error("Error: Invalid JSON: %s\n", json_string) - if cfg.speak_mode: - speak.say_text("Didn't work. I will have to ignore this response then.") - logger.error("Error: Invalid JSON, setting it to empty JSON now.\n") - json_string = {} - - return json_string - - -def print_assistant_thoughts(assistant_reply): - """Prints the assistant's thoughts to the console""" - global ai_name - global cfg - try: - try: - # Parse and print Assistant response - assistant_reply_json = fix_and_parse_json(assistant_reply) - except json.JSONDecodeError as e: - logger.error("Error: Invalid JSON in assistant thoughts\n", assistant_reply) - assistant_reply_json = attempt_to_fix_json_by_finding_outermost_brackets( - assistant_reply - ) - assistant_reply_json = fix_and_parse_json(assistant_reply_json) - - # Check if assistant_reply_json is a string and attempt to parse it into a - # JSON object - if isinstance(assistant_reply_json, str): - try: - assistant_reply_json = json.loads(assistant_reply_json) - except json.JSONDecodeError as e: - logger.error("Error: Invalid JSON\n", assistant_reply) - assistant_reply_json = ( - attempt_to_fix_json_by_finding_outermost_brackets( - assistant_reply_json - ) - ) - - assistant_thoughts_reasoning = None - assistant_thoughts_plan = None - assistant_thoughts_speak = None - assistant_thoughts_criticism = None - assistant_thoughts = assistant_reply_json.get("thoughts", {}) - assistant_thoughts_text = assistant_thoughts.get("text") - - if assistant_thoughts: - assistant_thoughts_reasoning = assistant_thoughts.get("reasoning") - assistant_thoughts_plan = assistant_thoughts.get("plan") - assistant_thoughts_criticism = assistant_thoughts.get("criticism") - assistant_thoughts_speak = assistant_thoughts.get("speak") - - logger.typewriter_log( - f"{ai_name.upper()} THOUGHTS:", Fore.YELLOW, f"{assistant_thoughts_text}" - ) - logger.typewriter_log( - "REASONING:", Fore.YELLOW, f"{assistant_thoughts_reasoning}" - ) - - if assistant_thoughts_plan: - logger.typewriter_log("PLAN:", Fore.YELLOW, "") - # If it's a list, join it into a string - if isinstance(assistant_thoughts_plan, list): - assistant_thoughts_plan = "\n".join(assistant_thoughts_plan) - elif isinstance(assistant_thoughts_plan, dict): - assistant_thoughts_plan = str(assistant_thoughts_plan) - - # Split the input_string using the newline character and dashes - lines = assistant_thoughts_plan.split("\n") - for line in lines: - line = line.lstrip("- ") - logger.typewriter_log("- ", Fore.GREEN, line.strip()) - - logger.typewriter_log( - "CRITICISM:", Fore.YELLOW, f"{assistant_thoughts_criticism}" - ) - # Speak the assistant's thoughts - if cfg.speak_mode and assistant_thoughts_speak: - speak.say_text(assistant_thoughts_speak) - - return assistant_reply_json - except json.decoder.JSONDecodeError: - call_stack = traceback.format_exc() - logger.error("Error: Invalid JSON\n", assistant_reply) - logger.error("Traceback: \n", call_stack) - if cfg.speak_mode: - speak.say_text( - "I have received an invalid JSON response from the OpenAI API." - " I cannot ignore this response." - ) - - # All other errors, return "Error: + error message" - except Exception: - call_stack = traceback.format_exc() - logger.error("Error: \n", call_stack) - - -def construct_prompt(): - """Construct the prompt for the AI to respond to""" - config: AIConfig = AIConfig.load(cfg.ai_settings_file) - if cfg.skip_reprompt and config.ai_name: - logger.typewriter_log("Name :", Fore.GREEN, config.ai_name) - logger.typewriter_log("Role :", Fore.GREEN, config.ai_role) - logger.typewriter_log("Goals:", Fore.GREEN, f"{config.ai_goals}") - elif config.ai_name: - logger.typewriter_log( - "Welcome back! ", - Fore.GREEN, - f"Would you like me to return to being {config.ai_name}?", - speak_text=True, - ) - should_continue = utils.clean_input( - f"""Continue with the last settings? -Name: {config.ai_name} -Role: {config.ai_role} -Goals: {config.ai_goals} -Continue (y/n): """ - ) - if should_continue.lower() == "n": - config = AIConfig() - - if not config.ai_name: - config = prompt_user() - config.save() - - # Get rid of this global: - global ai_name - ai_name = config.ai_name - - return config.construct_full_prompt() - - -def prompt_user(): - """Prompt the user for input""" - ai_name = "" - # Construct the prompt - logger.typewriter_log( - "Welcome to Auto-GPT! ", - Fore.GREEN, - "Enter the name of your AI and its role below. Entering nothing will load" - " defaults.", - speak_text=True, - ) - - # Get AI Name from User - logger.typewriter_log( - "Name your AI: ", Fore.GREEN, "For example, 'Entrepreneur-GPT'" - ) - ai_name = utils.clean_input("AI Name: ") - if ai_name == "": - ai_name = "Entrepreneur-GPT" - - logger.typewriter_log( - f"{ai_name} here!", Fore.LIGHTBLUE_EX, "I am at your service.", speak_text=True - ) - - # Get AI Role from User - logger.typewriter_log( - "Describe your AI's role: ", - Fore.GREEN, - "For example, 'an AI designed to autonomously develop and run businesses with" - " the sole goal of increasing your net worth.'", - ) - ai_role = utils.clean_input(f"{ai_name} is: ") - if ai_role == "": - ai_role = "an AI designed to autonomously develop and run businesses with the" - " sole goal of increasing your net worth." - - # Enter up to 5 goals for the AI - logger.typewriter_log( - "Enter up to 5 goals for your AI: ", - Fore.GREEN, - "For example: \nIncrease net worth, Grow Twitter Account, Develop and manage" - " multiple businesses autonomously'", - ) - print("Enter nothing to load defaults, enter nothing when finished.", flush=True) - ai_goals = [] - for i in range(5): - ai_goal = utils.clean_input(f"{Fore.LIGHTBLUE_EX}Goal{Style.RESET_ALL} {i+1}: ") - if ai_goal == "": - break - ai_goals.append(ai_goal) - if len(ai_goals) == 0: - ai_goals = [ - "Increase net worth", - "Grow Twitter Account", - "Develop and manage multiple businesses autonomously", - ] - - config = AIConfig(ai_name, ai_role, ai_goals) - return config - - -def parse_arguments(): - """Parses the arguments passed to the script""" - global cfg - cfg.set_debug_mode(False) - cfg.set_continuous_mode(False) - cfg.set_speak_mode(False) - - parser = argparse.ArgumentParser(description="Process arguments.") - parser.add_argument( - "--continuous", "-c", action="store_true", help="Enable Continuous Mode" - ) - parser.add_argument( - "--continuous-limit", - "-l", - type=int, - dest="continuous_limit", - help="Defines the number of times to run in continuous mode", - ) - parser.add_argument("--speak", action="store_true", help="Enable Speak Mode") - parser.add_argument("--debug", action="store_true", help="Enable Debug Mode") - parser.add_argument( - "--gpt3only", action="store_true", help="Enable GPT3.5 Only Mode" - ) - parser.add_argument("--gpt4only", action="store_true", help="Enable GPT4 Only Mode") - parser.add_argument( - "--use-memory", - "-m", - dest="memory_type", - help="Defines which Memory backend to use", - ) - parser.add_argument( - "--skip-reprompt", - "-y", - dest="skip_reprompt", - action="store_true", - help="Skips the re-prompting messages at the beginning of the script", - ) - parser.add_argument( - "--ai-settings", - "-C", - dest="ai_settings_file", - help="Specifies which ai_settings.yaml file to use, will also automatically" - " skip the re-prompt.", - ) - args = parser.parse_args() - - if args.debug: - logger.typewriter_log("Debug Mode: ", Fore.GREEN, "ENABLED") - cfg.set_debug_mode(True) - - if args.continuous: - logger.typewriter_log("Continuous Mode: ", Fore.RED, "ENABLED") - logger.typewriter_log( - "WARNING: ", - Fore.RED, - "Continuous mode is not recommended. It is potentially dangerous and may" - " cause your AI to run forever or carry out actions you would not usually" - " authorise. Use at your own risk.", - ) - cfg.set_continuous_mode(True) - - if args.continuous_limit: - logger.typewriter_log( - "Continuous Limit: ", Fore.GREEN, f"{args.continuous_limit}" - ) - cfg.set_continuous_limit(args.continuous_limit) - - # Check if continuous limit is used without continuous mode - if args.continuous_limit and not args.continuous: - parser.error("--continuous-limit can only be used with --continuous") - - if args.speak: - logger.typewriter_log("Speak Mode: ", Fore.GREEN, "ENABLED") - cfg.set_speak_mode(True) - - if args.gpt3only: - logger.typewriter_log("GPT3.5 Only Mode: ", Fore.GREEN, "ENABLED") - cfg.set_smart_llm_model(cfg.fast_llm_model) - - if args.gpt4only: - logger.typewriter_log("GPT4 Only Mode: ", Fore.GREEN, "ENABLED") - cfg.set_fast_llm_model(cfg.smart_llm_model) - - if args.memory_type: - supported_memory = get_supported_memory_backends() - chosen = args.memory_type - if not chosen in supported_memory: - logger.typewriter_log( - "ONLY THE FOLLOWING MEMORY BACKENDS ARE SUPPORTED: ", - Fore.RED, - f"{supported_memory}", - ) - logger.typewriter_log("Defaulting to: ", Fore.YELLOW, cfg.memory_backend) - else: - cfg.memory_backend = chosen - - if args.skip_reprompt: - logger.typewriter_log("Skip Re-prompt: ", Fore.GREEN, "ENABLED") - cfg.skip_reprompt = True - - if args.ai_settings_file: - file = args.ai_settings_file - - # Validate file - (validated, message) = utils.validate_yaml_file(file) - if not validated: - logger.typewriter_log("FAILED FILE VALIDATION", Fore.RED, message) - logger.double_check() - exit(1) - - logger.typewriter_log("Using AI Settings File:", Fore.GREEN, file) - cfg.ai_settings_file = file - cfg.skip_reprompt = True - - -def main(): - global ai_name, memory +def main() -> None: + """Main function for the script""" + cfg = Config() # TODO: fill in llm values here check_openai_api_key() parse_arguments() @@ -396,177 +45,5 @@ def main(): agent.start_interaction_loop() -class Agent: - """Agent class for interacting with Auto-GPT. - - Attributes: - ai_name: The name of the agent. - memory: The memory object to use. - full_message_history: The full message history. - next_action_count: The number of actions to execute. - prompt: The prompt to use. - user_input: The user input. - - """ - - def __init__( - self, - ai_name, - memory, - full_message_history, - next_action_count, - prompt, - user_input, - ): - self.ai_name = ai_name - self.memory = memory - self.full_message_history = full_message_history - self.next_action_count = next_action_count - self.prompt = prompt - self.user_input = user_input - - def start_interaction_loop(self): - # Interaction Loop - loop_count = 0 - command_name = None - arguments = None - while True: - # Discontinue if continuous limit is reached - loop_count += 1 - if ( - cfg.continuous_mode - and cfg.continuous_limit > 0 - and loop_count > cfg.continuous_limit - ): - logger.typewriter_log( - "Continuous Limit Reached: ", Fore.YELLOW, f"{cfg.continuous_limit}" - ) - break - - # Send message to AI, get response - with Spinner("Thinking... "): - assistant_reply = chat.chat_with_ai( - self.prompt, - self.user_input, - self.full_message_history, - self.memory, - cfg.fast_token_limit, - ) # TODO: This hardcodes the model to use GPT3.5. Make this an argument - - # Print Assistant thoughts - print_assistant_thoughts(assistant_reply) - - # Get command name and arguments - try: - command_name, arguments = cmd.get_command( - attempt_to_fix_json_by_finding_outermost_brackets(assistant_reply) - ) - if cfg.speak_mode: - speak.say_text(f"I want to execute {command_name}") - except Exception as e: - logger.error("Error: \n", str(e)) - - if not cfg.continuous_mode and self.next_action_count == 0: - ### GET USER AUTHORIZATION TO EXECUTE COMMAND ### - # Get key press: Prompt the user to press enter to continue or escape - # to exit - self.user_input = "" - logger.typewriter_log( - "NEXT ACTION: ", - Fore.CYAN, - f"COMMAND = {Fore.CYAN}{command_name}{Style.RESET_ALL}" - f" ARGUMENTS = {Fore.CYAN}{arguments}{Style.RESET_ALL}", - ) - print( - "Enter 'y' to authorise command, 'y -N' to run N continuous" - " commands, 'n' to exit program, or enter feedback for" - f" {self.ai_name}...", - flush=True, - ) - while True: - console_input = utils.clean_input( - Fore.MAGENTA + "Input:" + Style.RESET_ALL - ) - if console_input.lower().rstrip() == "y": - self.user_input = "GENERATE NEXT COMMAND JSON" - break - elif console_input.lower().startswith("y -"): - try: - self.next_action_count = abs( - int(console_input.split(" ")[1]) - ) - self.user_input = "GENERATE NEXT COMMAND JSON" - except ValueError: - print( - "Invalid input format. Please enter 'y -n' where n" - " is the number of continuous tasks." - ) - continue - break - elif console_input.lower() == "n": - self.user_input = "EXIT" - break - else: - self.user_input = console_input - command_name = "human_feedback" - break - - if self.user_input == "GENERATE NEXT COMMAND JSON": - logger.typewriter_log( - "-=-=-=-=-=-=-= COMMAND AUTHORISED BY USER -=-=-=-=-=-=-=", - Fore.MAGENTA, - "", - ) - elif self.user_input == "EXIT": - print("Exiting...", flush=True) - break - else: - # Print command - logger.typewriter_log( - "NEXT ACTION: ", - Fore.CYAN, - f"COMMAND = {Fore.CYAN}{command_name}{Style.RESET_ALL}" - f" ARGUMENTS = {Fore.CYAN}{arguments}{Style.RESET_ALL}", - ) - - # Execute command - if command_name is not None and command_name.lower().startswith("error"): - result = ( - f"Command {command_name} threw the following error: {arguments}" - ) - elif command_name == "human_feedback": - result = f"Human feedback: {self.user_input}" - else: - result = ( - f"Command {command_name} " - f"returned: {cmd.execute_command(command_name, arguments)}" - ) - if self.next_action_count > 0: - self.next_action_count -= 1 - - memory_to_add = ( - f"Assistant Reply: {assistant_reply} " - f"\nResult: {result} " - f"\nHuman Feedback: {self.user_input} " - ) - - self.memory.add(memory_to_add) - - # Check if there's a result from the command append it to the message - # history - if result is not None: - self.full_message_history.append( - chat.create_chat_message("system", result) - ) - logger.typewriter_log("SYSTEM: ", Fore.YELLOW, result) - else: - self.full_message_history.append( - chat.create_chat_message("system", "Unable to execute command") - ) - logger.typewriter_log( - "SYSTEM: ", Fore.YELLOW, "Unable to execute command" - ) - - if __name__ == "__main__": main() diff --git a/autogpt/agent/__init__.py b/autogpt/agent/__init__.py new file mode 100644 index 00000000..e928af22 --- /dev/null +++ b/autogpt/agent/__init__.py @@ -0,0 +1,4 @@ +from autogpt.agent.agent import Agent +from autogpt.agent.agent_manager import AgentManager + +__all__ = ["Agent", "AgentManager"] diff --git a/autogpt/agent.py b/autogpt/agent/agent.py similarity index 56% rename from autogpt/agent.py rename to autogpt/agent/agent.py index 56c13d17..301d3f02 100644 --- a/autogpt/agent.py +++ b/autogpt/agent/agent.py @@ -1,15 +1,13 @@ -import json -import regex -import traceback - from colorama import Fore, Style +from autogpt.app import execute_command, get_command from autogpt.chat import chat_with_ai, create_chat_message -import autogpt.commands as cmd from autogpt.config import Config -from autogpt.json_parser import fix_and_parse_json -from autogpt.logger import logger -from autogpt.speak import say_text +from autogpt.json_fixes.bracket_termination import ( + attempt_to_fix_json_by_finding_outermost_brackets, +) +from autogpt.logs import logger, print_assistant_thoughts +from autogpt.speech import say_text from autogpt.spinner import Spinner from autogpt.utils import clean_input @@ -77,7 +75,7 @@ class Agent: # Get command name and arguments try: - command_name, arguments = cmd.get_command( + command_name, arguments = get_command( attempt_to_fix_json_by_finding_outermost_brackets(assistant_reply) ) if cfg.speak_mode: @@ -158,7 +156,7 @@ class Agent: else: result = ( f"Command {command_name} returned: " - f"{cmd.execute_command(command_name, arguments)}" + f"{execute_command(command_name, arguments)}" ) if self.next_action_count > 0: self.next_action_count -= 1 @@ -183,122 +181,3 @@ class Agent: logger.typewriter_log( "SYSTEM: ", Fore.YELLOW, "Unable to execute command" ) - - -def attempt_to_fix_json_by_finding_outermost_brackets(json_string): - cfg = Config() - if cfg.speak_mode and cfg.debug_mode: - say_text( - "I have received an invalid JSON response from the OpenAI API. " - "Trying to fix it now." - ) - logger.typewriter_log("Attempting to fix JSON by finding outermost brackets\n") - - try: - json_pattern = regex.compile(r"\{(?:[^{}]|(?R))*\}") - json_match = json_pattern.search(json_string) - - if json_match: - # Extract the valid JSON object from the string - json_string = json_match.group(0) - logger.typewriter_log( - title="Apparently json was fixed.", title_color=Fore.GREEN - ) - if cfg.speak_mode and cfg.debug_mode: - say_text("Apparently json was fixed.") - else: - raise ValueError("No valid JSON object found") - - except (json.JSONDecodeError, ValueError): - if cfg.speak_mode: - say_text("Didn't work. I will have to ignore this response then.") - logger.error("Error: Invalid JSON, setting it to empty JSON now.\n") - json_string = {} - - return json_string - - -def print_assistant_thoughts(ai_name, assistant_reply): - """Prints the assistant's thoughts to the console""" - cfg = Config() - try: - try: - # Parse and print Assistant response - assistant_reply_json = fix_and_parse_json(assistant_reply) - except json.JSONDecodeError: - logger.error("Error: Invalid JSON in assistant thoughts\n", assistant_reply) - assistant_reply_json = attempt_to_fix_json_by_finding_outermost_brackets( - assistant_reply - ) - if isinstance(assistant_reply_json, str): - assistant_reply_json = fix_and_parse_json(assistant_reply_json) - - # Check if assistant_reply_json is a string and attempt to parse - # it into a JSON object - if isinstance(assistant_reply_json, str): - try: - assistant_reply_json = json.loads(assistant_reply_json) - except json.JSONDecodeError: - logger.error("Error: Invalid JSON\n", assistant_reply) - assistant_reply_json = ( - attempt_to_fix_json_by_finding_outermost_brackets( - assistant_reply_json - ) - ) - - assistant_thoughts_reasoning = None - assistant_thoughts_plan = None - assistant_thoughts_speak = None - assistant_thoughts_criticism = None - if not isinstance(assistant_reply_json, dict): - assistant_reply_json = {} - assistant_thoughts = assistant_reply_json.get("thoughts", {}) - assistant_thoughts_text = assistant_thoughts.get("text") - - if assistant_thoughts: - assistant_thoughts_reasoning = assistant_thoughts.get("reasoning") - assistant_thoughts_plan = assistant_thoughts.get("plan") - assistant_thoughts_criticism = assistant_thoughts.get("criticism") - assistant_thoughts_speak = assistant_thoughts.get("speak") - - logger.typewriter_log( - f"{ai_name.upper()} THOUGHTS:", Fore.YELLOW, f"{assistant_thoughts_text}" - ) - logger.typewriter_log( - "REASONING:", Fore.YELLOW, f"{assistant_thoughts_reasoning}" - ) - - if assistant_thoughts_plan: - logger.typewriter_log("PLAN:", Fore.YELLOW, "") - # If it's a list, join it into a string - if isinstance(assistant_thoughts_plan, list): - assistant_thoughts_plan = "\n".join(assistant_thoughts_plan) - elif isinstance(assistant_thoughts_plan, dict): - assistant_thoughts_plan = str(assistant_thoughts_plan) - - # Split the input_string using the newline character and dashes - lines = assistant_thoughts_plan.split("\n") - for line in lines: - line = line.lstrip("- ") - logger.typewriter_log("- ", Fore.GREEN, line.strip()) - - logger.typewriter_log( - "CRITICISM:", Fore.YELLOW, f"{assistant_thoughts_criticism}" - ) - # Speak the assistant's thoughts - if cfg.speak_mode and assistant_thoughts_speak: - say_text(assistant_thoughts_speak) - - return assistant_reply_json - except json.decoder.JSONDecodeError: - logger.error("Error: Invalid JSON\n", assistant_reply) - if cfg.speak_mode: - say_text( - "I have received an invalid JSON response from the OpenAI API." - " I cannot ignore this response." - ) - - # All other errors, return "Error: + error message" - except Exception: - call_stack = traceback.format_exc() - logger.error("Error: \n", call_stack) diff --git a/autogpt/agent/agent_manager.py b/autogpt/agent/agent_manager.py new file mode 100644 index 00000000..a22adff3 --- /dev/null +++ b/autogpt/agent/agent_manager.py @@ -0,0 +1,100 @@ +"""Agent manager for managing GPT agents""" +from typing import List, Tuple, Union +from autogpt.llm_utils import create_chat_completion +from autogpt.config.config import Singleton + + +class AgentManager(metaclass=Singleton): + """Agent manager for managing GPT agents""" + + def __init__(self): + self.next_key = 0 + self.agents = {} # key, (task, full_message_history, model) + + # Create new GPT agent + # TODO: Centralise use of create_chat_completion() to globally enforce token limit + + def create_agent(self, task: str, prompt: str, model: str) -> tuple[int, str]: + """Create a new agent and return its key + + Args: + task: The task to perform + prompt: The prompt to use + model: The model to use + + Returns: + The key of the new agent + """ + messages = [ + {"role": "user", "content": prompt}, + ] + + # Start GPT instance + agent_reply = create_chat_completion( + model=model, + messages=messages, + ) + + # Update full message history + messages.append({"role": "assistant", "content": agent_reply}) + + key = self.next_key + # This is done instead of len(agents) to make keys unique even if agents + # are deleted + self.next_key += 1 + + self.agents[key] = (task, messages, model) + + return key, agent_reply + + def message_agent(self, key: Union[str, int], message: str) -> str: + """Send a message to an agent and return its response + + Args: + key: The key of the agent to message + message: The message to send to the agent + + Returns: + The agent's response + """ + task, messages, model = self.agents[int(key)] + + # Add user message to message history before sending to agent + messages.append({"role": "user", "content": message}) + + # Start GPT instance + agent_reply = create_chat_completion( + model=model, + messages=messages, + ) + + # Update full message history + messages.append({"role": "assistant", "content": agent_reply}) + + return agent_reply + + def list_agents(self) -> List[Tuple[Union[str, int], str]]: + """Return a list of all agents + + Returns: + A list of tuples of the form (key, task) + """ + + # Return a list of agent keys and their tasks + return [(key, task) for key, (task, _, _) in self.agents.items()] + + def delete_agent(self, key: Union[str, int]) -> bool: + """Delete an agent from the agent manager + + Args: + key: The key of the agent to delete + + Returns: + True if successful, False otherwise + """ + + try: + del self.agents[int(key)] + return True + except KeyError: + return False diff --git a/autogpt/agent_manager.py b/autogpt/agent_manager.py deleted file mode 100644 index bbf156ee..00000000 --- a/autogpt/agent_manager.py +++ /dev/null @@ -1,75 +0,0 @@ -from autogpt.llm_utils import create_chat_completion - -next_key = 0 -agents = {} # key, (task, full_message_history, model) - -# Create new GPT agent -# TODO: Centralise use of create_chat_completion() to globally enforce token limit - - -def create_agent(task, prompt, model): - """Create a new agent and return its key""" - global next_key - global agents - - messages = [ - {"role": "user", "content": prompt}, - ] - - # Start GPT instance - agent_reply = create_chat_completion( - model=model, - messages=messages, - ) - - # Update full message history - messages.append({"role": "assistant", "content": agent_reply}) - - key = next_key - # This is done instead of len(agents) to make keys unique even if agents - # are deleted - next_key += 1 - - agents[key] = (task, messages, model) - - return key, agent_reply - - -def message_agent(key, message): - """Send a message to an agent and return its response""" - global agents - - task, messages, model = agents[int(key)] - - # Add user message to message history before sending to agent - messages.append({"role": "user", "content": message}) - - # Start GPT instance - agent_reply = create_chat_completion( - model=model, - messages=messages, - ) - - # Update full message history - messages.append({"role": "assistant", "content": agent_reply}) - - return agent_reply - - -def list_agents(): - """Return a list of all agents""" - global agents - - # Return a list of agent keys and their tasks - return [(key, task) for key, (task, _, _) in agents.items()] - - -def delete_agent(key): - """Delete an agent and return True if successful, False otherwise""" - global agents - - try: - del agents[int(key)] - return True - except KeyError: - return False diff --git a/autogpt/ai_functions.py b/autogpt/ai_functions.py deleted file mode 100644 index 84f82685..00000000 --- a/autogpt/ai_functions.py +++ /dev/null @@ -1,77 +0,0 @@ -import json -from typing import List - -from autogpt.call_ai_function import call_ai_function -from autogpt.config import Config - -cfg = Config() - - -def evaluate_code(code: str) -> List[str]: - """ - A function that takes in a string and returns a response from create chat - completion api call. - - Parameters: - code (str): Code to be evaluated. - Returns: - A result string from create chat completion. A list of suggestions to - improve the code. - """ - - function_string = "def analyze_code(code: str) -> List[str]:" - args = [code] - description_string = ( - "Analyzes the given code and returns a list of suggestions" " for improvements." - ) - - return call_ai_function(function_string, args, description_string) - - -def improve_code(suggestions: List[str], code: str) -> str: - """ - A function that takes in code and suggestions and returns a response from create - chat completion api call. - - Parameters: - suggestions (List): A list of suggestions around what needs to be improved. - code (str): Code to be improved. - Returns: - A result string from create chat completion. Improved code in response. - """ - - function_string = ( - "def generate_improved_code(suggestions: List[str], code: str) -> str:" - ) - args = [json.dumps(suggestions), code] - description_string = ( - "Improves the provided code based on the suggestions" - " provided, making no other changes." - ) - - return call_ai_function(function_string, args, description_string) - - -def write_tests(code: str, focus: List[str]) -> str: - """ - A function that takes in code and focus topics and returns a response from create - chat completion api call. - - Parameters: - focus (List): A list of suggestions around what needs to be improved. - code (str): Code for test cases to be generated against. - Returns: - A result string from create chat completion. Test cases for the submitted code - in response. - """ - - function_string = ( - "def create_test_cases(code: str, focus: Optional[str] = None) -> str:" - ) - args = [code, json.dumps(focus)] - description_string = ( - "Generates test cases for the existing code, focusing on" - " specific areas if required." - ) - - return call_ai_function(function_string, args, description_string) diff --git a/autogpt/commands.py b/autogpt/app.py similarity index 61% rename from autogpt/commands.py rename to autogpt/app.py index 352b3340..0adfde5d 100644 --- a/autogpt/commands.py +++ b/autogpt/app.py @@ -1,29 +1,42 @@ +""" Command and Control """ import json -import datetime -import autogpt.agent_manager as agents +from typing import List, NoReturn, Union +from autogpt.agent.agent_manager import AgentManager +from autogpt.commands.evaluate_code import evaluate_code +from autogpt.commands.google_search import google_official_search, google_search +from autogpt.commands.improve_code import improve_code +from autogpt.commands.write_tests import write_tests from autogpt.config import Config -from autogpt.json_parser import fix_and_parse_json -from autogpt.image_gen import generate_image -from duckduckgo_search import ddg -from autogpt.ai_functions import evaluate_code, improve_code, write_tests -from autogpt.browse import scrape_links, scrape_text, summarize_text -from autogpt.execute_code import execute_python_file, execute_shell -from autogpt.file_operations import ( +from autogpt.commands.image_gen import generate_image +from autogpt.commands.web_requests import scrape_links, scrape_text +from autogpt.commands.execute_code import execute_python_file, execute_shell +from autogpt.commands.file_operations import ( append_to_file, delete_file, read_file, search_files, write_to_file, ) +from autogpt.json_fixes.parsing import fix_and_parse_json from autogpt.memory import get_memory -from autogpt.speak import say_text -from autogpt.web import browse_website +from autogpt.processing.text import summarize_text +from autogpt.speech import say_text +from autogpt.commands.web_selenium import browse_website -cfg = Config() +CFG = Config() +AGENT_MANAGER = AgentManager() -def is_valid_int(value) -> bool: +def is_valid_int(value: str) -> bool: + """Check if the value is a valid integer + + Args: + value (str): The value to check + + Returns: + bool: True if the value is a valid integer, False otherwise + """ try: int(value) return True @@ -31,8 +44,20 @@ def is_valid_int(value) -> bool: return False -def get_command(response): - """Parse the response and return the command name and arguments""" +def get_command(response: str): + """Parse the response and return the command name and arguments + + Args: + response (str): The response from the user + + Returns: + tuple: The command name and arguments + + Raises: + json.decoder.JSONDecodeError: If the response is not valid JSON + + Exception: If any other error occurs + """ try: response_json = fix_and_parse_json(response) @@ -62,16 +87,23 @@ def get_command(response): return "Error:", str(e) -def execute_command(command_name, arguments): - """Execute the command and return the result""" - memory = get_memory(cfg) +def execute_command(command_name: str, arguments): + """Execute the command and return the result + + Args: + command_name (str): The name of the command to execute + arguments (dict): The arguments for the command + + Returns: + str: The result of the command""" + memory = get_memory(CFG) try: if command_name == "google": # Check if the Google API key is set and use the official search method # If the API key is not set or has only whitespaces, use the unofficial # search method - key = cfg.google_api_key + key = CFG.google_api_key if key and key.strip() and key != "your-google-api-key": return google_official_search(arguments["input"]) else: @@ -116,7 +148,7 @@ def execute_command(command_name, arguments): elif command_name == "execute_python_file": # Add this command return execute_python_file(arguments["file"]) elif command_name == "execute_shell": - if cfg.execute_local_commands: + if CFG.execute_local_commands: return execute_shell(arguments["command_line"]) else: return ( @@ -136,96 +168,55 @@ def execute_command(command_name, arguments): " list for available commands and only respond in the specified JSON" " format." ) - # All errors, return "Error: + error message" except Exception as e: - return "Error: " + str(e) + return f"Error: {str(e)}" -def get_datetime(): - """Return the current date and time""" - return "Current date and time: " + datetime.datetime.now().strftime( - "%Y-%m-%d %H:%M:%S" - ) +def get_text_summary(url: str, question: str) -> str: + """Return the results of a google search + Args: + url (str): The url to scrape + question (str): The question to summarize the text for -def google_search(query, num_results=8): - """Return the results of a google search""" - search_results = [] - if not query: - return json.dumps(search_results) - - for j in ddg(query, max_results=num_results): - search_results.append(j) - - return json.dumps(search_results, ensure_ascii=False, indent=4) - - -def google_official_search(query, num_results=8): - """Return the results of a google search using the official Google API""" - import json - - from googleapiclient.discovery import build - from googleapiclient.errors import HttpError - - try: - # Get the Google API key and Custom Search Engine ID from the config file - api_key = cfg.google_api_key - custom_search_engine_id = cfg.custom_search_engine_id - - # Initialize the Custom Search API service - service = build("customsearch", "v1", developerKey=api_key) - - # Send the search query and retrieve the results - result = ( - service.cse() - .list(q=query, cx=custom_search_engine_id, num=num_results) - .execute() - ) - - # Extract the search result items from the response - search_results = result.get("items", []) - - # Create a list of only the URLs from the search results - search_results_links = [item["link"] for item in search_results] - - except HttpError as e: - # Handle errors in the API call - error_details = json.loads(e.content.decode()) - - # Check if the error is related to an invalid or missing API key - if error_details.get("error", {}).get( - "code" - ) == 403 and "invalid API key" in error_details.get("error", {}).get( - "message", "" - ): - return "Error: The provided Google API key is invalid or missing." - else: - return f"Error: {e}" - - # Return the list of search result URLs - return search_results_links - - -def get_text_summary(url, question): - """Return the results of a google search""" + Returns: + str: The summary of the text + """ text = scrape_text(url) summary = summarize_text(url, text, question) - return """ "Result" : """ + summary + return f""" "Result" : {summary}""" -def get_hyperlinks(url): - """Return the results of a google search""" +def get_hyperlinks(url: str) -> Union[str, List[str]]: + """Return the results of a google search + + Args: + url (str): The url to scrape + + Returns: + str or list: The hyperlinks on the page + """ return scrape_links(url) -def shutdown(): +def shutdown() -> NoReturn: """Shut down the program""" print("Shutting down...") quit() -def start_agent(name, task, prompt, model=cfg.fast_llm_model): - """Start an agent with a given name, task, and prompt""" +def start_agent(name: str, task: str, prompt: str, model=CFG.fast_llm_model) -> str: + """Start an agent with a given name, task, and prompt + + Args: + name (str): The name of the agent + task (str): The task of the agent + prompt (str): The prompt for the agent + model (str): The model to use for the agent + + Returns: + str: The response of the agent + """ # Remove underscores from name voice_name = name.replace("_", " ") @@ -233,42 +224,53 @@ def start_agent(name, task, prompt, model=cfg.fast_llm_model): agent_intro = f"{voice_name} here, Reporting for duty!" # Create agent - if cfg.speak_mode: + if CFG.speak_mode: say_text(agent_intro, 1) - key, ack = agents.create_agent(task, first_message, model) + key, ack = AGENT_MANAGER.create_agent(task, first_message, model) - if cfg.speak_mode: + if CFG.speak_mode: say_text(f"Hello {voice_name}. Your task is as follows. {task}.") # Assign task (prompt), get response - agent_response = agents.message_agent(key, prompt) + agent_response = AGENT_MANAGER.message_agent(key, prompt) return f"Agent {name} created with key {key}. First response: {agent_response}" -def message_agent(key, message): +def message_agent(key: str, message: str) -> str: """Message an agent with a given key and message""" # Check if the key is a valid integer if is_valid_int(key): - agent_response = agents.message_agent(int(key), message) + agent_response = AGENT_MANAGER.message_agent(int(key), message) # Check if the key is a valid string elif isinstance(key, str): - agent_response = agents.message_agent(key, message) + agent_response = AGENT_MANAGER.message_agent(key, message) else: return "Invalid key, must be an integer or a string." # Speak response - if cfg.speak_mode: + if CFG.speak_mode: say_text(agent_response, 1) return agent_response def list_agents(): - """List all agents""" - return list_agents() + """List all agents + + Returns: + list: A list of all agents + """ + return AGENT_MANAGER.list_agents() -def delete_agent(key): - """Delete an agent with a given key""" - result = agents.delete_agent(key) +def delete_agent(key: str) -> str: + """Delete an agent with a given key + + Args: + key (str): The key of the agent to delete + + Returns: + str: A message indicating whether the agent was deleted or not + """ + result = AGENT_MANAGER.delete_agent(key) return f"Agent {key} deleted." if result else f"Agent {key} does not exist." diff --git a/autogpt/args.py b/autogpt/args.py new file mode 100644 index 00000000..6c907a1f --- /dev/null +++ b/autogpt/args.py @@ -0,0 +1,128 @@ +"""This module contains the argument parsing logic for the script.""" +import argparse + +from colorama import Fore +from autogpt import utils +from autogpt.config import Config +from autogpt.logs import logger +from autogpt.memory import get_supported_memory_backends + +CFG = Config() + + +def parse_arguments() -> None: + """Parses the arguments passed to the script + + Returns: + None + """ + CFG.set_debug_mode(False) + CFG.set_continuous_mode(False) + CFG.set_speak_mode(False) + + parser = argparse.ArgumentParser(description="Process arguments.") + parser.add_argument( + "--continuous", "-c", action="store_true", help="Enable Continuous Mode" + ) + parser.add_argument( + "--continuous-limit", + "-l", + type=int, + dest="continuous_limit", + help="Defines the number of times to run in continuous mode", + ) + parser.add_argument("--speak", action="store_true", help="Enable Speak Mode") + parser.add_argument("--debug", action="store_true", help="Enable Debug Mode") + parser.add_argument( + "--gpt3only", action="store_true", help="Enable GPT3.5 Only Mode" + ) + parser.add_argument("--gpt4only", action="store_true", help="Enable GPT4 Only Mode") + parser.add_argument( + "--use-memory", + "-m", + dest="memory_type", + help="Defines which Memory backend to use", + ) + parser.add_argument( + "--skip-reprompt", + "-y", + dest="skip_reprompt", + action="store_true", + help="Skips the re-prompting messages at the beginning of the script", + ) + parser.add_argument( + "--ai-settings", + "-C", + dest="ai_settings_file", + help="Specifies which ai_settings.yaml file to use, will also automatically" + " skip the re-prompt.", + ) + args = parser.parse_args() + + if args.debug: + logger.typewriter_log("Debug Mode: ", Fore.GREEN, "ENABLED") + CFG.set_debug_mode(True) + + if args.continuous: + logger.typewriter_log("Continuous Mode: ", Fore.RED, "ENABLED") + logger.typewriter_log( + "WARNING: ", + Fore.RED, + "Continuous mode is not recommended. It is potentially dangerous and may" + " cause your AI to run forever or carry out actions you would not usually" + " authorise. Use at your own risk.", + ) + CFG.set_continuous_mode(True) + + if args.continuous_limit: + logger.typewriter_log( + "Continuous Limit: ", Fore.GREEN, f"{args.continuous_limit}" + ) + CFG.set_continuous_limit(args.continuous_limit) + + # Check if continuous limit is used without continuous mode + if args.continuous_limit and not args.continuous: + parser.error("--continuous-limit can only be used with --continuous") + + if args.speak: + logger.typewriter_log("Speak Mode: ", Fore.GREEN, "ENABLED") + CFG.set_speak_mode(True) + + if args.gpt3only: + logger.typewriter_log("GPT3.5 Only Mode: ", Fore.GREEN, "ENABLED") + CFG.set_smart_llm_model(CFG.fast_llm_model) + + if args.gpt4only: + logger.typewriter_log("GPT4 Only Mode: ", Fore.GREEN, "ENABLED") + CFG.set_fast_llm_model(CFG.smart_llm_model) + + if args.memory_type: + supported_memory = get_supported_memory_backends() + chosen = args.memory_type + if chosen not in supported_memory: + logger.typewriter_log( + "ONLY THE FOLLOWING MEMORY BACKENDS ARE SUPPORTED: ", + Fore.RED, + f"{supported_memory}", + ) + logger.typewriter_log("Defaulting to: ", Fore.YELLOW, CFG.memory_backend) + else: + CFG.memory_backend = chosen + + if args.skip_reprompt: + logger.typewriter_log("Skip Re-prompt: ", Fore.GREEN, "ENABLED") + CFG.skip_reprompt = True + + if args.ai_settings_file: + file = args.ai_settings_file + + # Validate file + (validated, message) = utils.validate_yaml_file(file) + if not validated: + logger.typewriter_log("FAILED FILE VALIDATION", Fore.RED, message) + logger.double_check() + exit(1) + + logger.typewriter_log("Using AI Settings File:", Fore.GREEN, file) + CFG.ai_settings_file = file + CFG.skip_reprompt = True diff --git a/autogpt/call_ai_function.py b/autogpt/call_ai_function.py deleted file mode 100644 index bbbd8e35..00000000 --- a/autogpt/call_ai_function.py +++ /dev/null @@ -1,26 +0,0 @@ -from autogpt.config import Config -from autogpt.llm_utils import create_chat_completion - -cfg = Config() - - -# This is a magic function that can do anything with no-code. See -# https://github.com/Torantulino/AI-Functions for more info. -def call_ai_function(function, args, description, model=None) -> str: - """Call an AI function""" - if model is None: - model = cfg.smart_llm_model - # For each arg, if any are None, convert to "None": - args = [str(arg) if arg is not None else "None" for arg in args] - # parse args to comma separated string - args = ", ".join(args) - messages = [ - { - "role": "system", - "content": f"You are now the following python function: ```# {description}" - f"\n{function}```\n\nOnly respond with your `return` value.", - }, - {"role": "user", "content": args}, - ] - - return create_chat_completion(model=model, messages=messages, temperature=0) diff --git a/autogpt/chat.py b/autogpt/chat.py index 12797d9f..b0886967 100644 --- a/autogpt/chat.py +++ b/autogpt/chat.py @@ -5,7 +5,7 @@ from openai.error import RateLimitError from autogpt import token_counter from autogpt.config import Config from autogpt.llm_utils import create_chat_completion -from autogpt.logger import logger +from autogpt.logs import logger cfg = Config() diff --git a/autogpt/commands/__init__.py b/autogpt/commands/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/autogpt/commands/evaluate_code.py b/autogpt/commands/evaluate_code.py new file mode 100644 index 00000000..a36952e5 --- /dev/null +++ b/autogpt/commands/evaluate_code.py @@ -0,0 +1,25 @@ +"""Code evaluation module.""" +from typing import List + +from autogpt.llm_utils import call_ai_function + + +def evaluate_code(code: str) -> List[str]: + """ + A function that takes in a string and returns a response from create chat + completion api call. + + Parameters: + code (str): Code to be evaluated. + Returns: + A result string from create chat completion. A list of suggestions to + improve the code. + """ + + function_string = "def analyze_code(code: str) -> List[str]:" + args = [code] + description_string = ( + "Analyzes the given code and returns a list of suggestions" " for improvements." + ) + + return call_ai_function(function_string, args, description_string) diff --git a/autogpt/commands/execute_code.py b/autogpt/commands/execute_code.py new file mode 100644 index 00000000..db33490c --- /dev/null +++ b/autogpt/commands/execute_code.py @@ -0,0 +1,125 @@ +"""Execute code in a Docker container""" +import os +from pathlib import Path +import subprocess + +import docker +from docker.errors import ImageNotFound + +WORKING_DIRECTORY = Path(__file__).parent.parent / "auto_gpt_workspace" + + +def execute_python_file(file: str): + """Execute a Python file in a Docker container and return the output + + Args: + file (str): The name of the file to execute + + Returns: + str: The output of the file + """ + + print(f"Executing file '{file}' in workspace '{WORKING_DIRECTORY}'") + + if not file.endswith(".py"): + return "Error: Invalid file type. Only .py files are allowed." + + file_path = os.path.join(WORKING_DIRECTORY, file) + + if not os.path.isfile(file_path): + return f"Error: File '{file}' does not exist." + + if we_are_running_in_a_docker_container(): + result = subprocess.run( + f"python {file_path}", capture_output=True, encoding="utf8", shell=True + ) + if result.returncode == 0: + return result.stdout + else: + return f"Error: {result.stderr}" + + try: + client = docker.from_env() + + image_name = "python:3.10" + try: + client.images.get(image_name) + print(f"Image '{image_name}' found locally") + except ImageNotFound: + print(f"Image '{image_name}' not found locally, pulling from Docker Hub") + # Use the low-level API to stream the pull response + low_level_client = docker.APIClient() + for line in low_level_client.pull(image_name, stream=True, decode=True): + # Print the status and progress, if available + status = line.get("status") + progress = line.get("progress") + if status and progress: + print(f"{status}: {progress}") + elif status: + print(status) + + # You can replace 'python:3.8' with the desired Python image/version + # You can find available Python images on Docker Hub: + # https://hub.docker.com/_/python + container = client.containers.run( + image_name, + f"python {file}", + volumes={ + os.path.abspath(WORKING_DIRECTORY): { + "bind": "/workspace", + "mode": "ro", + } + }, + working_dir="/workspace", + stderr=True, + stdout=True, + detach=True, + ) + + container.wait() + logs = container.logs().decode("utf-8") + container.remove() + + # print(f"Execution complete. Output: {output}") + # print(f"Logs: {logs}") + + return logs + + except Exception as e: + return f"Error: {str(e)}" + + +def execute_shell(command_line: str) -> str: + """Execute a shell command and return the output + + Args: + command_line (str): The command line to execute + + Returns: + str: The output of the command + """ + current_dir = os.getcwd() + + if WORKING_DIRECTORY not in current_dir: # Change dir into workspace if necessary + work_dir = os.path.join(os.getcwd(), WORKING_DIRECTORY) + os.chdir(work_dir) + + print(f"Executing command '{command_line}' in working directory '{os.getcwd()}'") + + result = subprocess.run(command_line, capture_output=True, shell=True) + output = f"STDOUT:\n{result.stdout}\nSTDERR:\n{result.stderr}" + + # Change back to whatever the prior working dir was + + os.chdir(current_dir) + + return output + + +def we_are_running_in_a_docker_container() -> bool: + """Check if we are running in a Docker container + + Returns: + bool: True if we are running in a Docker container, False otherwise + """ + return os.path.exists("/.dockerenv") diff --git a/autogpt/file_operations.py b/autogpt/commands/file_operations.py similarity index 58% rename from autogpt/file_operations.py rename to autogpt/commands/file_operations.py index 1c8f9290..9d11a878 100644 --- a/autogpt/file_operations.py +++ b/autogpt/commands/file_operations.py @@ -1,16 +1,29 @@ +"""File operations for AutoGPT""" import os import os.path +from pathlib import Path +from typing import Generator, List # Set a dedicated folder for file I/O -working_directory = "auto_gpt_workspace" +WORKING_DIRECTORY = Path(__file__).parent.parent / "auto_gpt_workspace" # Create the directory if it doesn't exist -if not os.path.exists(working_directory): - os.makedirs(working_directory) +if not os.path.exists(WORKING_DIRECTORY): + os.makedirs(WORKING_DIRECTORY) + +WORKING_DIRECTORY = str(WORKING_DIRECTORY) -def safe_join(base, *paths): - """Join one or more path components intelligently.""" +def safe_join(base: str, *paths) -> str: + """Join one or more path components intelligently. + + Args: + base (str): The base path + *paths (str): The paths to join to the base path + + Returns: + str: The joined path + """ new_path = os.path.join(base, *paths) norm_new_path = os.path.normpath(new_path) @@ -20,7 +33,9 @@ def safe_join(base, *paths): return norm_new_path -def split_file(content, max_length=4000, overlap=0): +def split_file( + content: str, max_length: int = 4000, overlap: int = 0 +) -> Generator[str, None, None]: """ Split text into chunks of a specified maximum length with a specified overlap between chunks. @@ -45,10 +60,17 @@ def split_file(content, max_length=4000, overlap=0): start += max_length - overlap -def read_file(filename) -> str: - """Read a file and return the contents""" +def read_file(filename: str) -> str: + """Read a file and return the contents + + Args: + filename (str): The name of the file to read + + Returns: + str: The contents of the file + """ try: - filepath = safe_join(working_directory, filename) + filepath = safe_join(WORKING_DIRECTORY, filename) with open(filepath, "r", encoding="utf-8") as f: content = f.read() return content @@ -56,7 +78,9 @@ def read_file(filename) -> str: return f"Error: {str(e)}" -def ingest_file(filename, memory, max_length=4000, overlap=200): +def ingest_file( + filename: str, memory, max_length: int = 4000, overlap: int = 200 +) -> None: """ Ingest a file by reading its content, splitting it into chunks with a specified maximum length and overlap, and adding the chunks to the memory storage. @@ -88,10 +112,18 @@ def ingest_file(filename, memory, max_length=4000, overlap=200): print(f"Error while ingesting file '{filename}': {str(e)}") -def write_to_file(filename, text): - """Write text to a file""" +def write_to_file(filename: str, text: str) -> str: + """Write text to a file + + Args: + filename (str): The name of the file to write to + text (str): The text to write to the file + + Returns: + str: A message indicating success or failure + """ try: - filepath = safe_join(working_directory, filename) + filepath = safe_join(WORKING_DIRECTORY, filename) directory = os.path.dirname(filepath) if not os.path.exists(directory): os.makedirs(directory) @@ -99,43 +131,66 @@ def write_to_file(filename, text): f.write(text) return "File written to successfully." except Exception as e: - return "Error: " + str(e) + return f"Error: {str(e)}" -def append_to_file(filename, text): - """Append text to a file""" +def append_to_file(filename: str, text: str) -> str: + """Append text to a file + + Args: + filename (str): The name of the file to append to + text (str): The text to append to the file + + Returns: + str: A message indicating success or failure + """ try: - filepath = safe_join(working_directory, filename) + filepath = safe_join(WORKING_DIRECTORY, filename) with open(filepath, "a") as f: f.write(text) return "Text appended successfully." except Exception as e: - return "Error: " + str(e) + return f"Error: {str(e)}" -def delete_file(filename): - """Delete a file""" +def delete_file(filename: str) -> str: + """Delete a file + + Args: + filename (str): The name of the file to delete + + Returns: + str: A message indicating success or failure + """ try: - filepath = safe_join(working_directory, filename) + filepath = safe_join(WORKING_DIRECTORY, filename) os.remove(filepath) return "File deleted successfully." except Exception as e: - return "Error: " + str(e) + return f"Error: {str(e)}" -def search_files(directory): +def search_files(directory: str) -> List[str]: + """Search for files in a directory + + Args: + directory (str): The directory to search in + + Returns: + List[str]: A list of files found in the directory + """ found_files = [] - if directory == "" or directory == "/": - search_directory = working_directory + if directory in {"", "/"}: + search_directory = WORKING_DIRECTORY else: - search_directory = safe_join(working_directory, directory) + search_directory = safe_join(WORKING_DIRECTORY, directory) for root, _, files in os.walk(search_directory): for file in files: if file.startswith("."): continue - relative_path = os.path.relpath(os.path.join(root, file), working_directory) + relative_path = os.path.relpath(os.path.join(root, file), WORKING_DIRECTORY) found_files.append(relative_path) return found_files diff --git a/autogpt/commands/google_search.py b/autogpt/commands/google_search.py new file mode 100644 index 00000000..6deb9b50 --- /dev/null +++ b/autogpt/commands/google_search.py @@ -0,0 +1,86 @@ +"""Google search command for Autogpt.""" +import json +from typing import List, Union + +from duckduckgo_search import ddg + +from autogpt.config import Config + +CFG = Config() + + +def google_search(query: str, num_results: int = 8) -> str: + """Return the results of a google search + + Args: + query (str): The search query. + num_results (int): The number of results to return. + + Returns: + str: The results of the search. + """ + search_results = [] + if not query: + return json.dumps(search_results) + + results = ddg(query, max_results=num_results) + if not results: + return json.dumps(search_results) + + for j in results: + search_results.append(j) + + return json.dumps(search_results, ensure_ascii=False, indent=4) + + +def google_official_search(query: str, num_results: int = 8) -> Union[str, List[str]]: + """Return the results of a google search using the official Google API + + Args: + query (str): The search query. + num_results (int): The number of results to return. + + Returns: + str: The results of the search. + """ + + from googleapiclient.discovery import build + from googleapiclient.errors import HttpError + + try: + # Get the Google API key and Custom Search Engine ID from the config file + api_key = CFG.google_api_key + custom_search_engine_id = CFG.custom_search_engine_id + + # Initialize the Custom Search API service + service = build("customsearch", "v1", developerKey=api_key) + + # Send the search query and retrieve the results + result = ( + service.cse() + .list(q=query, cx=custom_search_engine_id, num=num_results) + .execute() + ) + + # Extract the search result items from the response + search_results = result.get("items", []) + + # Create a list of only the URLs from the search results + search_results_links = [item["link"] for item in search_results] + + except HttpError as e: + # Handle errors in the API call + error_details = json.loads(e.content.decode()) + + # Check if the error is related to an invalid or missing API key + if error_details.get("error", {}).get( + "code" + ) == 403 and "invalid API key" in error_details.get("error", {}).get( + "message", "" + ): + return "Error: The provided Google API key is invalid or missing." + else: + return f"Error: {e}" + + # Return the list of search result URLs + return search_results_links diff --git a/autogpt/commands/image_gen.py b/autogpt/commands/image_gen.py new file mode 100644 index 00000000..39e08845 --- /dev/null +++ b/autogpt/commands/image_gen.py @@ -0,0 +1,99 @@ +""" Image Generation Module for AutoGPT.""" +import io +import os.path +import uuid +from base64 import b64decode + +import openai +import requests +from PIL import Image +from pathlib import Path +from autogpt.config import Config + +CFG = Config() + +WORKING_DIRECTORY = Path(__file__).parent.parent / "auto_gpt_workspace" + + +def generate_image(prompt: str) -> str: + """Generate an image from a prompt. + + Args: + prompt (str): The prompt to use + + Returns: + str: The filename of the image + """ + filename = f"{str(uuid.uuid4())}.jpg" + + # DALL-E + if CFG.image_provider == "dalle": + return generate_image_with_dalle(prompt, filename) + elif CFG.image_provider == "sd": + return generate_image_with_hf(prompt, filename) + else: + return "No Image Provider Set" + + +def generate_image_with_hf(prompt: str, filename: str) -> str: + """Generate an image with HuggingFace's API. + + Args: + prompt (str): The prompt to use + filename (str): The filename to save the image to + + Returns: + str: The filename of the image + """ + API_URL = ( + "https://api-inference.huggingface.co/models/CompVis/stable-diffusion-v1-4" + ) + if CFG.huggingface_api_token is None: + raise ValueError( + "You need to set your Hugging Face API token in the config file." + ) + headers = {"Authorization": f"Bearer {CFG.huggingface_api_token}"} + + response = requests.post( + API_URL, + headers=headers, + json={ + "inputs": prompt, + }, + ) + + image = Image.open(io.BytesIO(response.content)) + print(f"Image Generated for prompt:{prompt}") + + image.save(os.path.join(WORKING_DIRECTORY, filename)) + + return f"Saved to disk:{filename}" + + +def generate_image_with_dalle(prompt: str, filename: str) -> str: + """Generate an image with DALL-E. + + Args: + prompt (str): The prompt to use + filename (str): The filename to save the image to + + Returns: + str: The filename of the image + """ + openai.api_key = CFG.openai_api_key + + response = openai.Image.create( + prompt=prompt, + n=1, + size="256x256", + response_format="b64_json", + ) + + print(f"Image Generated for prompt:{prompt}") + + image_data = b64decode(response["data"][0]["b64_json"]) + + with open(f"{WORKING_DIRECTORY}/{filename}", mode="wb") as png: + png.write(image_data) + + return f"Saved to disk:{filename}" diff --git a/autogpt/commands/improve_code.py b/autogpt/commands/improve_code.py new file mode 100644 index 00000000..05fe89e9 --- /dev/null +++ b/autogpt/commands/improve_code.py @@ -0,0 +1,28 @@ +import json +from typing import List + +from autogpt.llm_utils import call_ai_function + + +def improve_code(suggestions: List[str], code: str) -> str: + """ + A function that takes in code and suggestions and returns a response from create + chat completion api call. + + Parameters: + suggestions (List): A list of suggestions around what needs to be improved. + code (str): Code to be improved. + Returns: + A result string from create chat completion. Improved code in response. + """ + + function_string = ( + "def generate_improved_code(suggestions: List[str], code: str) -> str:" + ) + args = [json.dumps(suggestions), code] + description_string = ( + "Improves the provided code based on the suggestions" + " provided, making no other changes." + ) + + return call_ai_function(function_string, args, description_string) diff --git a/autogpt/commands/times.py b/autogpt/commands/times.py new file mode 100644 index 00000000..3c9b8a4f --- /dev/null +++ b/autogpt/commands/times.py @@ -0,0 +1,10 @@ +from datetime import datetime + + +def get_datetime() -> str: + """Return the current date and time + + Returns: + str: The current date and time + """ + return "Current date and time: " + datetime.now().strftime("%Y-%m-%d %H:%M:%S") diff --git a/autogpt/browse.py b/autogpt/commands/web_requests.py similarity index 51% rename from autogpt/browse.py rename to autogpt/commands/web_requests.py index 60d33744..59c3e522 100644 --- a/autogpt/browse.py +++ b/autogpt/commands/web_requests.py @@ -1,21 +1,30 @@ +"""Browse a webpage and summarize it using the LLM model""" +from typing import List, Tuple, Union from urllib.parse import urljoin, urlparse import requests +from requests import Response from bs4 import BeautifulSoup from autogpt.config import Config -from autogpt.llm_utils import create_chat_completion from autogpt.memory import get_memory -cfg = Config() -memory = get_memory(cfg) +CFG = Config() +memory = get_memory(CFG) session = requests.Session() -session.headers.update({"User-Agent": cfg.user_agent}) +session.headers.update({"User-Agent": CFG.user_agent}) -# Function to check if the URL is valid -def is_valid_url(url): +def is_valid_url(url: str) -> bool: + """Check if the URL is valid + + Args: + url (str): The URL to check + + Returns: + bool: True if the URL is valid, False otherwise + """ try: result = urlparse(url) return all([result.scheme, result.netloc]) @@ -23,13 +32,27 @@ def is_valid_url(url): return False -# Function to sanitize the URL -def sanitize_url(url): +def sanitize_url(url: str) -> str: + """Sanitize the URL + + Args: + url (str): The URL to sanitize + + Returns: + str: The sanitized URL + """ return urljoin(url, urlparse(url).path) -# Define and check for local file address prefixes -def check_local_file_access(url): +def check_local_file_access(url: str) -> bool: + """Check if the URL is a local file + + Args: + url (str): The URL to check + + Returns: + bool: True if the URL is a local file, False otherwise + """ local_prefixes = [ "file:///", "file://localhost", @@ -39,7 +62,22 @@ def check_local_file_access(url): return any(url.startswith(prefix) for prefix in local_prefixes) -def get_response(url, timeout=10): +def get_response( + url: str, timeout: int = 10 +) -> Union[Tuple[None, str], Tuple[Response, None]]: + """Get the response from a URL + + Args: + url (str): The URL to get the response from + timeout (int): The timeout for the HTTP request + + Returns: + tuple[None, str] | tuple[Response, None]: The response and error message + + Raises: + ValueError: If the URL is invalid + requests.exceptions.RequestException: If the HTTP request fails + """ try: # Restrict access to local files if check_local_file_access(url): @@ -55,21 +93,28 @@ def get_response(url, timeout=10): # Check if the response contains an HTTP error if response.status_code >= 400: - return None, "Error: HTTP " + str(response.status_code) + " error" + return None, f"Error: HTTP {str(response.status_code)} error" return response, None except ValueError as ve: # Handle invalid URL format - return None, "Error: " + str(ve) + return None, f"Error: {str(ve)}" except requests.exceptions.RequestException as re: # Handle exceptions related to the HTTP request # (e.g., connection errors, timeouts, etc.) - return None, "Error: " + str(re) + return None, f"Error: {str(re)}" -def scrape_text(url): - """Scrape text from a webpage""" +def scrape_text(url: str) -> str: + """Scrape text from a webpage + + Args: + url (str): The URL to scrape text from + + Returns: + str: The scraped text + """ response, error_message = get_response(url) if error_message: return error_message @@ -89,24 +134,45 @@ def scrape_text(url): return text -def extract_hyperlinks(soup): - """Extract hyperlinks from a BeautifulSoup object""" +def extract_hyperlinks(soup: BeautifulSoup) -> List[Tuple[str, str]]: + """Extract hyperlinks from a BeautifulSoup object + + Args: + soup (BeautifulSoup): The BeautifulSoup object + + Returns: + List[Tuple[str, str]]: The extracted hyperlinks + """ hyperlinks = [] for link in soup.find_all("a", href=True): hyperlinks.append((link.text, link["href"])) return hyperlinks -def format_hyperlinks(hyperlinks): - """Format hyperlinks into a list of strings""" +def format_hyperlinks(hyperlinks: List[Tuple[str, str]]) -> List[str]: + """Format hyperlinks into a list of strings + + Args: + hyperlinks (List[Tuple[str, str]]): The hyperlinks to format + + Returns: + List[str]: The formatted hyperlinks + """ formatted_links = [] for link_text, link_url in hyperlinks: formatted_links.append(f"{link_text} ({link_url})") return formatted_links -def scrape_links(url): - """Scrape links from a webpage""" +def scrape_links(url: str) -> Union[str, List[str]]: + """Scrape links from a webpage + + Args: + url (str): The URL to scrape links from + + Returns: + Union[str, List[str]]: The scraped links + """ response, error_message = get_response(url) if error_message: return error_message @@ -122,25 +188,6 @@ def scrape_links(url): return format_hyperlinks(hyperlinks) -def split_text(text, max_length=cfg.browse_chunk_max_length): - """Split text into chunks of a maximum length""" - paragraphs = text.split("\n") - current_length = 0 - current_chunk = [] - - for paragraph in paragraphs: - if current_length + len(paragraph) + 1 <= max_length: - current_chunk.append(paragraph) - current_length += len(paragraph) + 1 - else: - yield "\n".join(current_chunk) - current_chunk = [paragraph] - current_length = len(paragraph) + 1 - - if current_chunk: - yield "\n".join(current_chunk) - - def create_message(chunk, question): """Create a message for the user to summarize a chunk of text""" return { @@ -149,50 +196,3 @@ def create_message(chunk, question): f' question: "{question}" -- if the question cannot be answered using the' " text, please summarize the text.", } - - -def summarize_text(url, text, question): - """Summarize text using the LLM model""" - if not text: - return "Error: No text to summarize" - - text_length = len(text) - print(f"Text length: {text_length} characters") - - summaries = [] - chunks = list(split_text(text)) - - for i, chunk in enumerate(chunks): - print(f"Adding chunk {i + 1} / {len(chunks)} to memory") - - memory_to_add = f"Source: {url}\n" f"Raw content part#{i + 1}: {chunk}" - - memory.add(memory_to_add) - - print(f"Summarizing chunk {i + 1} / {len(chunks)}") - messages = [create_message(chunk, question)] - - summary = create_chat_completion( - model=cfg.fast_llm_model, - messages=messages, - max_tokens=cfg.browse_summary_max_token, - ) - summaries.append(summary) - print(f"Added chunk {i + 1} summary to memory") - - memory_to_add = f"Source: {url}\n" f"Content summary part#{i + 1}: {summary}" - - memory.add(memory_to_add) - - print(f"Summarized {len(chunks)} chunks.") - - combined_summary = "\n".join(summaries) - messages = [create_message(combined_summary, question)] - - final_summary = create_chat_completion( - model=cfg.fast_llm_model, - messages=messages, - max_tokens=cfg.browse_summary_max_token, - ) - - return final_summary diff --git a/autogpt/commands/web_selenium.py b/autogpt/commands/web_selenium.py new file mode 100644 index 00000000..4d5703aa --- /dev/null +++ b/autogpt/commands/web_selenium.py @@ -0,0 +1,145 @@ +"""Selenium web scraping module.""" +from selenium import webdriver +import autogpt.processing.text as summary +from bs4 import BeautifulSoup +from selenium.webdriver.remote.webdriver import WebDriver +from selenium.webdriver.common.by import By +from selenium.webdriver.support.wait import WebDriverWait +from selenium.webdriver.support import expected_conditions as EC +from webdriver_manager.chrome import ChromeDriverManager +from selenium.webdriver.chrome.options import Options +import logging +from pathlib import Path +from autogpt.config import Config + +FILE_DIR = Path(__file__).parent.parent +CFG = Config() + + +def browse_website(url: str, question: str) -> tuple[str, WebDriver]: + """Browse a website and return the answer and links to the user + + Args: + url (str): The url of the website to browse + question (str): The question asked by the user + + Returns: + tuple[str, WebDriver]: The answer and links to the user and the webdriver + """ + driver, text = scrape_text_with_selenium(url) + add_header(driver) + summary_text = summary.summarize_text(url, text, question, driver) + links = scrape_links_with_selenium(driver) + + # Limit links to 5 + if len(links) > 5: + links = links[:5] + close_browser(driver) + return f"Answer gathered from website: {summary_text} \n \n Links: {links}", driver + + +def scrape_text_with_selenium(url: str) -> tuple[WebDriver, str]: + """Scrape text from a website using selenium + + Args: + url (str): The url of the website to scrape + + Returns: + tuple[WebDriver, str]: The webdriver and the text scraped from the website + """ + logging.getLogger("selenium").setLevel(logging.CRITICAL) + + options = Options() + options.add_argument( + "user-agent=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36" + " (KHTML, like Gecko) Chrome/112.0.5615.49 Safari/537.36" + ) + driver = webdriver.Chrome( + executable_path=ChromeDriverManager().install(), options=options + ) + driver.get(url) + + WebDriverWait(driver, 10).until( + EC.presence_of_element_located((By.TAG_NAME, "body")) + ) + + # Get the HTML content directly from the browser's DOM + page_source = driver.execute_script("return document.body.outerHTML;") + soup = BeautifulSoup(page_source, "html.parser") + + for script in soup(["script", "style"]): + script.extract() + + text = soup.get_text() + lines = (line.strip() for line in text.splitlines()) + chunks = (phrase.strip() for line in lines for phrase in line.split(" ")) + text = "\n".join(chunk for chunk in chunks if chunk) + return driver, text + + +def scrape_links_with_selenium(driver: WebDriver) -> list[str]: + """Scrape links from a website using selenium + + Args: + driver (WebDriver): The webdriver to use to scrape the links + + Returns: + list[str]: The links scraped from the website + """ + page_source = driver.page_source + soup = BeautifulSoup(page_source, "html.parser") + + for script in soup(["script", "style"]): + script.extract() + + hyperlinks = extract_hyperlinks(soup) + + return format_hyperlinks(hyperlinks) + + +def close_browser(driver: WebDriver) -> None: + """Close the browser + + Args: + driver (WebDriver): The webdriver to close + + Returns: + None + """ + driver.quit() + + +def extract_hyperlinks(soup: BeautifulSoup) -> list[tuple[str, str]]: + """Extract hyperlinks from a BeautifulSoup object + + Args: + soup (BeautifulSoup): The BeautifulSoup object to extract the hyperlinks from + + Returns: + list[tuple[str, str]]: The hyperlinks extracted from the BeautifulSoup object + """ + return [(link.text, link["href"]) for link in soup.find_all("a", href=True)] + + +def format_hyperlinks(hyperlinks: list[tuple[str, str]]) -> list[str]: + """Format hyperlinks to be displayed to the user + + Args: + hyperlinks (list[tuple[str, str]]): The hyperlinks to format + + Returns: + list[str]: The formatted hyperlinks + """ + return [f"{link_text} ({link_url})" for link_text, link_url in hyperlinks] + + +def add_header(driver: WebDriver) -> None: + """Add a header to the website + + Args: + driver (WebDriver): The webdriver to use to add the header + + Returns: + None + """ + driver.execute_script(open(f"{FILE_DIR}/js/overlay.js", "r").read()) diff --git a/autogpt/commands/write_tests.py b/autogpt/commands/write_tests.py new file mode 100644 index 00000000..f1d6c9b2 --- /dev/null +++ b/autogpt/commands/write_tests.py @@ -0,0 +1,29 @@ +"""A module that contains a function to generate test cases for the submitted code.""" +import json +from typing import List +from autogpt.llm_utils import call_ai_function + + +def write_tests(code: str, focus: List[str]) -> str: + """ + A function that takes in code and focus topics and returns a response from create + chat completion api call. + + Parameters: + focus (List): A list of suggestions around what needs to be improved. + code (str): Code for test cases to be generated against. + Returns: + A result string from create chat completion. Test cases for the submitted code + in response. + """ + + function_string = ( + "def create_test_cases(code: str, focus: Optional[str] = None) -> str:" + ) + args = [code, json.dumps(focus)] + description_string = ( + "Generates test cases for the existing code, focusing on" + " specific areas if required." + ) + + return call_ai_function(function_string, args, description_string) diff --git a/autogpt/config/__init__.py b/autogpt/config/__init__.py new file mode 100644 index 00000000..ceb5566c --- /dev/null +++ b/autogpt/config/__init__.py @@ -0,0 +1,14 @@ +""" +This module contains the configuration classes for AutoGPT. +""" +from autogpt.config.ai_config import AIConfig +from autogpt.config.config import check_openai_api_key, Config +from autogpt.config.singleton import AbstractSingleton, Singleton + +__all__ = [ + "check_openai_api_key", + "AbstractSingleton", + "AIConfig", + "Config", + "Singleton", +] diff --git a/autogpt/ai_config.py b/autogpt/config/ai_config.py similarity index 87% rename from autogpt/ai_config.py rename to autogpt/config/ai_config.py index 0957b886..c72b088b 100644 --- a/autogpt/ai_config.py +++ b/autogpt/config/ai_config.py @@ -1,9 +1,11 @@ +# sourcery skip: do-not-use-staticmethod +""" +A module that contains the AIConfig class object that contains the configuration +""" import os -from typing import Type +from typing import List, Optional, Type import yaml -from autogpt.prompt import get_prompt - class AIConfig: """ @@ -16,7 +18,7 @@ class AIConfig: """ def __init__( - self, ai_name: str = "", ai_role: str = "", ai_goals: list = [] + self, ai_name: str = "", ai_role: str = "", ai_goals: Optional[List] = None ) -> None: """ Initialize a class instance @@ -28,7 +30,8 @@ class AIConfig: Returns: None """ - + if ai_goals is None: + ai_goals = [] self.ai_name = ai_name self.ai_role = ai_role self.ai_goals = ai_goals @@ -36,15 +39,14 @@ class AIConfig: # Soon this will go in a folder where it remembers more stuff about the run(s) SAVE_FILE = os.path.join(os.path.dirname(__file__), "..", "ai_settings.yaml") - @classmethod - def load(cls: "Type[AIConfig]", config_file: str = SAVE_FILE) -> "Type[AIConfig]": + @staticmethod + def load(config_file: str = SAVE_FILE) -> "AIConfig": """ Returns class object with parameters (ai_name, ai_role, ai_goals) loaded from yaml file if yaml file exists, else returns class with no parameters. Parameters: - cls (class object): An AIConfig Class object. config_file (int): The path to the config yaml file. DEFAULT: "../ai_settings.yaml" @@ -62,7 +64,7 @@ class AIConfig: ai_role = config_params.get("ai_role", "") ai_goals = config_params.get("ai_goals", []) # type: Type[AIConfig] - return cls(ai_name, ai_role, ai_goals) + return AIConfig(ai_name, ai_role, ai_goals) def save(self, config_file: str = SAVE_FILE) -> None: """ @@ -103,6 +105,8 @@ class AIConfig: "" ) + from autogpt.prompt import get_prompt + # Construct full prompt full_prompt = ( f"You are {self.ai_name}, {self.ai_role}\n{prompt_start}\n\nGOALS:\n\n" diff --git a/autogpt/config.py b/autogpt/config/config.py similarity index 76% rename from autogpt/config.py rename to autogpt/config/config.py index 26132a5a..46764b9c 100644 --- a/autogpt/config.py +++ b/autogpt/config/config.py @@ -1,30 +1,15 @@ -import abc +"""Configuration class to store the state of bools for different scripts access.""" import os +from colorama import Fore + +from autogpt.config.singleton import Singleton import openai import yaml + from dotenv import load_dotenv -# Load environment variables from .env file -load_dotenv() - - -class Singleton(abc.ABCMeta, type): - """ - Singleton metaclass for ensuring only one instance of a class. - """ - - _instances = {} - - def __call__(cls, *args, **kwargs): - """Call method for the singleton metaclass.""" - if cls not in cls._instances: - cls._instances[cls] = super(Singleton, cls).__call__(*args, **kwargs) - return cls._instances[cls] - - -class AbstractSingleton(abc.ABC, metaclass=Singleton): - pass +load_dotenv(verbose=True) class Config(metaclass=Singleton): @@ -32,7 +17,7 @@ class Config(metaclass=Singleton): Configuration class to store the state of bools for different scripts access. """ - def __init__(self): + def __init__(self) -> None: """Initialize the Config class""" self.debug_mode = False self.continuous_mode = False @@ -81,10 +66,12 @@ class Config(metaclass=Singleton): self.huggingface_api_token = os.getenv("HUGGINGFACE_API_TOKEN") # User agent headers to use when browsing web - # Some websites might just completely deny request with an error code if no user agent was found. + # Some websites might just completely deny request with an error code if + # no user agent was found. self.user_agent = os.getenv( "USER_AGENT", - "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.97 Safari/537.36", + "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_4) AppleWebKit/537.36" + " (KHTML, like Gecko) Chrome/83.0.4103.97 Safari/537.36", ) self.redis_host = os.getenv("REDIS_HOST", "localhost") self.redis_port = os.getenv("REDIS_PORT", "6379") @@ -108,15 +95,17 @@ class Config(metaclass=Singleton): The matching deployment id if found, otherwise an empty string. """ if model == self.fast_llm_model: - return self.azure_model_to_deployment_id_map["fast_llm_model_deployment_id"] + return self.azure_model_to_deployment_id_map[ + "fast_llm_model_deployment_id" + ] # type: ignore elif model == self.smart_llm_model: return self.azure_model_to_deployment_id_map[ "smart_llm_model_deployment_id" - ] + ] # type: ignore elif model == "text-embedding-ada-002": return self.azure_model_to_deployment_id_map[ "embedding_model_deployment_id" - ] + ] # type: ignore else: return "" @@ -124,7 +113,8 @@ class Config(metaclass=Singleton): def load_azure_config(self, config_file: str = AZURE_CONFIG_FILE) -> None: """ - Loads the configuration parameters for Azure hosting from the specified file path as a yaml file. + Loads the configuration parameters for Azure hosting from the specified file + path as a yaml file. Parameters: config_file(str): The path to the config yaml file. DEFAULT: "../azure.yaml" @@ -148,74 +138,86 @@ class Config(metaclass=Singleton): ) self.azure_model_to_deployment_id_map = config_params.get("azure_model_map", []) - def set_continuous_mode(self, value: bool): + def set_continuous_mode(self, value: bool) -> None: """Set the continuous mode value.""" self.continuous_mode = value - def set_continuous_limit(self, value: int): + def set_continuous_limit(self, value: int) -> None: """Set the continuous limit value.""" self.continuous_limit = value - def set_speak_mode(self, value: bool): + def set_speak_mode(self, value: bool) -> None: """Set the speak mode value.""" self.speak_mode = value - def set_fast_llm_model(self, value: str): + def set_fast_llm_model(self, value: str) -> None: """Set the fast LLM model value.""" self.fast_llm_model = value - def set_smart_llm_model(self, value: str): + def set_smart_llm_model(self, value: str) -> None: """Set the smart LLM model value.""" self.smart_llm_model = value - def set_fast_token_limit(self, value: int): + def set_fast_token_limit(self, value: int) -> None: """Set the fast token limit value.""" self.fast_token_limit = value - def set_smart_token_limit(self, value: int): + def set_smart_token_limit(self, value: int) -> None: """Set the smart token limit value.""" self.smart_token_limit = value - def set_browse_chunk_max_length(self, value: int): + def set_browse_chunk_max_length(self, value: int) -> None: """Set the browse_website command chunk max length value.""" self.browse_chunk_max_length = value - def set_browse_summary_max_token(self, value: int): + def set_browse_summary_max_token(self, value: int) -> None: """Set the browse_website command summary max token value.""" self.browse_summary_max_token = value - def set_openai_api_key(self, value: str): + def set_openai_api_key(self, value: str) -> None: """Set the OpenAI API key value.""" self.openai_api_key = value - def set_elevenlabs_api_key(self, value: str): + def set_elevenlabs_api_key(self, value: str) -> None: """Set the ElevenLabs API key value.""" self.elevenlabs_api_key = value - def set_elevenlabs_voice_1_id(self, value: str): + def set_elevenlabs_voice_1_id(self, value: str) -> None: """Set the ElevenLabs Voice 1 ID value.""" self.elevenlabs_voice_1_id = value - def set_elevenlabs_voice_2_id(self, value: str): + def set_elevenlabs_voice_2_id(self, value: str) -> None: """Set the ElevenLabs Voice 2 ID value.""" self.elevenlabs_voice_2_id = value - def set_google_api_key(self, value: str): + def set_google_api_key(self, value: str) -> None: """Set the Google API key value.""" self.google_api_key = value - def set_custom_search_engine_id(self, value: str): + def set_custom_search_engine_id(self, value: str) -> None: """Set the custom search engine id value.""" self.custom_search_engine_id = value - def set_pinecone_api_key(self, value: str): + def set_pinecone_api_key(self, value: str) -> None: """Set the Pinecone API key value.""" self.pinecone_api_key = value - def set_pinecone_region(self, value: str): + def set_pinecone_region(self, value: str) -> None: """Set the Pinecone region value.""" self.pinecone_region = value - def set_debug_mode(self, value: bool): + def set_debug_mode(self, value: bool) -> None: """Set the debug mode value.""" self.debug_mode = value + + +def check_openai_api_key() -> None: + """Check if the OpenAI API key is set in config.py or as an environment variable.""" + cfg = Config() + if not cfg.openai_api_key: + print( + Fore.RED + + "Please set your OpenAI API key in .env or as an environment variable." + ) + print("You can get your key from https://beta.openai.com/account/api-keys") + exit(1) diff --git a/autogpt/config/singleton.py b/autogpt/config/singleton.py new file mode 100644 index 00000000..55b2aeea --- /dev/null +++ b/autogpt/config/singleton.py @@ -0,0 +1,24 @@ +"""The singleton metaclass for ensuring only one instance of a class.""" +import abc + + +class Singleton(abc.ABCMeta, type): + """ + Singleton metaclass for ensuring only one instance of a class. + """ + + _instances = {} + + def __call__(cls, *args, **kwargs): + """Call method for the singleton metaclass.""" + if cls not in cls._instances: + cls._instances[cls] = super(Singleton, cls).__call__(*args, **kwargs) + return cls._instances[cls] + + +class AbstractSingleton(abc.ABC, metaclass=Singleton): + """ + Abstract singleton class for ensuring only one instance of a class. + """ + + pass diff --git a/autogpt/data_ingestion.py b/autogpt/data_ingestion.py index 9df2b9e6..01bafc2a 100644 --- a/autogpt/data_ingestion.py +++ b/autogpt/data_ingestion.py @@ -2,7 +2,7 @@ import argparse import logging from autogpt.config import Config -from autogpt.file_operations import ingest_file, search_files +from autogpt.commands.file_operations import ingest_file, search_files from autogpt.memory import get_memory cfg = Config() @@ -87,7 +87,8 @@ def main() -> None: print(f"Error while ingesting directory '{args.dir}': {str(e)}") else: print( - "Please provide either a file path (--file) or a directory name (--dir) inside the auto_gpt_workspace directory as input." + "Please provide either a file path (--file) or a directory name (--dir)" + " inside the auto_gpt_workspace directory as input." ) diff --git a/autogpt/execute_code.py b/autogpt/execute_code.py deleted file mode 100644 index c5f85a04..00000000 --- a/autogpt/execute_code.py +++ /dev/null @@ -1,105 +0,0 @@ -import os -import subprocess - -import docker -from docker.errors import ImageNotFound - -WORKSPACE_FOLDER = "auto_gpt_workspace" - - -def execute_python_file(file): - """Execute a Python file in a Docker container and return the output""" - - print(f"Executing file '{file}' in workspace '{WORKSPACE_FOLDER}'") - - if not file.endswith(".py"): - return "Error: Invalid file type. Only .py files are allowed." - - file_path = os.path.join(WORKSPACE_FOLDER, file) - - if not os.path.isfile(file_path): - return f"Error: File '{file}' does not exist." - - if we_are_running_in_a_docker_container(): - result = subprocess.run( - f"python {file_path}", capture_output=True, encoding="utf8", shell=True - ) - if result.returncode == 0: - return result.stdout - else: - return f"Error: {result.stderr}" - else: - try: - client = docker.from_env() - - image_name = "python:3.10" - try: - client.images.get(image_name) - print(f"Image '{image_name}' found locally") - except ImageNotFound: - print( - f"Image '{image_name}' not found locally, pulling from Docker Hub" - ) - # Use the low-level API to stream the pull response - low_level_client = docker.APIClient() - for line in low_level_client.pull(image_name, stream=True, decode=True): - # Print the status and progress, if available - status = line.get("status") - progress = line.get("progress") - if status and progress: - print(f"{status}: {progress}") - elif status: - print(status) - - # You can replace 'python:3.8' with the desired Python image/version - # You can find available Python images on Docker Hub: - # https://hub.docker.com/_/python - container = client.containers.run( - image_name, - f"python {file}", - volumes={ - os.path.abspath(WORKSPACE_FOLDER): { - "bind": "/workspace", - "mode": "ro", - } - }, - working_dir="/workspace", - stderr=True, - stdout=True, - detach=True, - ) - - container.wait() - logs = container.logs().decode("utf-8") - container.remove() - - # print(f"Execution complete. Output: {output}") - # print(f"Logs: {logs}") - - return logs - - except Exception as e: - return f"Error: {str(e)}" - - -def execute_shell(command_line): - current_dir = os.getcwd() - - if WORKSPACE_FOLDER not in current_dir: # Change dir into workspace if necessary - work_dir = os.path.join(os.getcwd(), WORKSPACE_FOLDER) - os.chdir(work_dir) - - print(f"Executing command '{command_line}' in working directory '{os.getcwd()}'") - - result = subprocess.run(command_line, capture_output=True, shell=True) - output = f"STDOUT:\n{result.stdout}\nSTDERR:\n{result.stderr}" - - # Change back to whatever the prior working dir was - - os.chdir(current_dir) - - return output - - -def we_are_running_in_a_docker_container(): - os.path.exists("/.dockerenv") diff --git a/autogpt/image_gen.py b/autogpt/image_gen.py deleted file mode 100644 index 9d5694e4..00000000 --- a/autogpt/image_gen.py +++ /dev/null @@ -1,67 +0,0 @@ -import io -import os.path -import uuid -from base64 import b64decode - -import openai -import requests -from PIL import Image - -from autogpt.config import Config - -cfg = Config() - -working_directory = "auto_gpt_workspace" - - -def generate_image(prompt): - filename = str(uuid.uuid4()) + ".jpg" - - # DALL-E - if cfg.image_provider == "dalle": - openai.api_key = cfg.openai_api_key - - response = openai.Image.create( - prompt=prompt, - n=1, - size="256x256", - response_format="b64_json", - ) - - print("Image Generated for prompt:" + prompt) - - image_data = b64decode(response["data"][0]["b64_json"]) - - with open(working_directory + "/" + filename, mode="wb") as png: - png.write(image_data) - - return "Saved to disk:" + filename - - # STABLE DIFFUSION - elif cfg.image_provider == "sd": - API_URL = ( - "https://api-inference.huggingface.co/models/CompVis/stable-diffusion-v1-4" - ) - if cfg.huggingface_api_token is None: - raise ValueError( - "You need to set your Hugging Face API token in the config file." - ) - headers = {"Authorization": "Bearer " + cfg.huggingface_api_token} - - response = requests.post( - API_URL, - headers=headers, - json={ - "inputs": prompt, - }, - ) - - image = Image.open(io.BytesIO(response.content)) - print("Image Generated for prompt:" + prompt) - - image.save(os.path.join(working_directory, filename)) - - return "Saved to disk:" + filename - - else: - return "No Image Provider Set" diff --git a/autogpt/json_fixes/__init__.py b/autogpt/json_fixes/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/autogpt/json_fixes/auto_fix.py b/autogpt/json_fixes/auto_fix.py new file mode 100644 index 00000000..60c089a2 --- /dev/null +++ b/autogpt/json_fixes/auto_fix.py @@ -0,0 +1,40 @@ +"""This module contains the function to fix JSON strings using GPT-3.""" +import json +from autogpt.llm_utils import call_ai_function +from autogpt.logs import logger + + +def fix_json(json_str: str, schema: str) -> str: + """Fix the given JSON string to make it parseable and fully compliant with the provided schema.""" + # Try to fix the JSON using GPT: + function_string = "def fix_json(json_str: str, schema:str=None) -> str:" + args = [f"'''{json_str}'''", f"'''{schema}'''"] + description_string = ( + "Fixes the provided JSON string to make it parseable" + " and fully compliant with the provided schema.\n If an object or" + " field specified in the schema isn't contained within the correct" + " JSON, it is omitted.\n This function is brilliant at guessing" + " when the format is incorrect." + ) + + # If it doesn't already start with a "`", add one: + if not json_str.startswith("`"): + json_str = "```json\n" + json_str + "\n```" + result_string = call_ai_function( + function_string, args, description_string, model=cfg.fast_llm_model + ) + logger.debug("------------ JSON FIX ATTEMPT ---------------") + logger.debug(f"Original JSON: {json_str}") + logger.debug("-----------") + logger.debug(f"Fixed JSON: {result_string}") + logger.debug("----------- END OF FIX ATTEMPT ----------------") + + try: + json.loads(result_string) # just check the validity + return result_string + except: # noqa: E722 + # Get the call stack: + # import traceback + # call_stack = traceback.format_exc() + # print(f"Failed to fix JSON: '{json_str}' "+call_stack) + return "failed" diff --git a/autogpt/json_fixes/bracket_termination.py b/autogpt/json_fixes/bracket_termination.py new file mode 100644 index 00000000..13c2ccfd --- /dev/null +++ b/autogpt/json_fixes/bracket_termination.py @@ -0,0 +1,73 @@ +"""Fix JSON brackets.""" +import contextlib +import json +from typing import Optional +import regex +from colorama import Fore + +from autogpt.logs import logger +from autogpt.config import Config +from autogpt.speech import say_text + +CFG = Config() + + +def attempt_to_fix_json_by_finding_outermost_brackets(json_string: str): + if CFG.speak_mode and CFG.debug_mode: + say_text( + "I have received an invalid JSON response from the OpenAI API. " + "Trying to fix it now." + ) + logger.typewriter_log("Attempting to fix JSON by finding outermost brackets\n") + + try: + json_pattern = regex.compile(r"\{(?:[^{}]|(?R))*\}") + json_match = json_pattern.search(json_string) + + if json_match: + # Extract the valid JSON object from the string + json_string = json_match.group(0) + logger.typewriter_log( + title="Apparently json was fixed.", title_color=Fore.GREEN + ) + if CFG.speak_mode and CFG.debug_mode: + say_text("Apparently json was fixed.") + else: + raise ValueError("No valid JSON object found") + + except (json.JSONDecodeError, ValueError): + if CFG.debug_mode: + logger.error("Error: Invalid JSON: %s\n", json_string) + if CFG.speak_mode: + say_text("Didn't work. I will have to ignore this response then.") + logger.error("Error: Invalid JSON, setting it to empty JSON now.\n") + json_string = {} + + return json_string + + +def balance_braces(json_string: str) -> Optional[str]: + """ + Balance the braces in a JSON string. + + Args: + json_string (str): The JSON string. + + Returns: + str: The JSON string with braces balanced. + """ + + open_braces_count = json_string.count("{") + close_braces_count = json_string.count("}") + + while open_braces_count > close_braces_count: + json_string += "}" + close_braces_count += 1 + + while close_braces_count > open_braces_count: + json_string = json_string.rstrip("}") + close_braces_count -= 1 + + with contextlib.suppress(json.JSONDecodeError): + json.loads(json_string) + return json_string diff --git a/autogpt/json_fixes/escaping.py b/autogpt/json_fixes/escaping.py new file mode 100644 index 00000000..68eb1714 --- /dev/null +++ b/autogpt/json_fixes/escaping.py @@ -0,0 +1,33 @@ +""" Fix invalid escape sequences in JSON strings. """ +import json + +from autogpt.config import Config +from autogpt.json_fixes.utilities import extract_char_position + +CFG = Config() + + +def fix_invalid_escape(json_to_load: str, error_message: str) -> str: + """Fix invalid escape sequences in JSON strings. + + Args: + json_to_load (str): The JSON string. + error_message (str): The error message from the JSONDecodeError + exception. + + Returns: + str: The JSON string with invalid escape sequences fixed. + """ + while error_message.startswith("Invalid \\escape"): + bad_escape_location = extract_char_position(error_message) + json_to_load = ( + json_to_load[:bad_escape_location] + json_to_load[bad_escape_location + 1 :] + ) + try: + json.loads(json_to_load) + return json_to_load + except json.JSONDecodeError as e: + if CFG.debug_mode: + print("json loads error - fix invalid escape", e) + error_message = str(e) + return json_to_load diff --git a/autogpt/json_fixes/missing_quotes.py b/autogpt/json_fixes/missing_quotes.py new file mode 100644 index 00000000..552a1517 --- /dev/null +++ b/autogpt/json_fixes/missing_quotes.py @@ -0,0 +1,27 @@ +"""Fix quotes in a JSON string.""" +import json +import re + + +def add_quotes_to_property_names(json_string: str) -> str: + """ + Add quotes to property names in a JSON string. + + Args: + json_string (str): The JSON string. + + Returns: + str: The JSON string with quotes added to property names. + """ + + def replace_func(match: re.Match) -> str: + return f'"{match[1]}":' + + property_name_pattern = re.compile(r"(\w+):") + corrected_json_string = property_name_pattern.sub(replace_func, json_string) + + try: + json.loads(corrected_json_string) + return corrected_json_string + except json.JSONDecodeError as e: + raise e diff --git a/autogpt/json_fixes/parsing.py b/autogpt/json_fixes/parsing.py new file mode 100644 index 00000000..26d06793 --- /dev/null +++ b/autogpt/json_fixes/parsing.py @@ -0,0 +1,143 @@ +"""Fix and parse JSON strings.""" + +import contextlib +import json +from typing import Any, Dict, Union + +from autogpt.config import Config +from autogpt.json_fixes.auto_fix import fix_json +from autogpt.json_fixes.bracket_termination import balance_braces +from autogpt.json_fixes.escaping import fix_invalid_escape +from autogpt.json_fixes.missing_quotes import add_quotes_to_property_names +from autogpt.logs import logger + +CFG = Config() + + +JSON_SCHEMA = """ +{ + "command": { + "name": "command name", + "args": { + "arg name": "value" + } + }, + "thoughts": + { + "text": "thought", + "reasoning": "reasoning", + "plan": "- short bulleted\n- list that conveys\n- long-term plan", + "criticism": "constructive self-criticism", + "speak": "thoughts summary to say to user" + } +} +""" + + +def correct_json(json_to_load: str) -> str: + """ + Correct common JSON errors. + + Args: + json_to_load (str): The JSON string. + """ + + try: + if CFG.debug_mode: + print("json", json_to_load) + json.loads(json_to_load) + return json_to_load + except json.JSONDecodeError as e: + if CFG.debug_mode: + print("json loads error", e) + error_message = str(e) + if error_message.startswith("Invalid \\escape"): + json_to_load = fix_invalid_escape(json_to_load, error_message) + if error_message.startswith( + "Expecting property name enclosed in double quotes" + ): + json_to_load = add_quotes_to_property_names(json_to_load) + try: + json.loads(json_to_load) + return json_to_load + except json.JSONDecodeError as e: + if CFG.debug_mode: + print("json loads error - add quotes", e) + error_message = str(e) + if balanced_str := balance_braces(json_to_load): + return balanced_str + return json_to_load + + +def fix_and_parse_json( + json_to_load: str, try_to_fix_with_gpt: bool = True +) -> Union[str, Dict[Any, Any]]: + """Fix and parse JSON string + + Args: + json_to_load (str): The JSON string. + try_to_fix_with_gpt (bool, optional): Try to fix the JSON with GPT. + Defaults to True. + + Returns: + Union[str, Dict[Any, Any]]: The parsed JSON. + """ + + with contextlib.suppress(json.JSONDecodeError): + json_to_load = json_to_load.replace("\t", "") + return json.loads(json_to_load) + + with contextlib.suppress(json.JSONDecodeError): + json_to_load = correct_json(json_to_load) + return json.loads(json_to_load) + # Let's do something manually: + # sometimes GPT responds with something BEFORE the braces: + # "I'm sorry, I don't understand. Please try again." + # {"text": "I'm sorry, I don't understand. Please try again.", + # "confidence": 0.0} + # So let's try to find the first brace and then parse the rest + # of the string + try: + brace_index = json_to_load.index("{") + maybe_fixed_json = json_to_load[brace_index:] + last_brace_index = maybe_fixed_json.rindex("}") + maybe_fixed_json = maybe_fixed_json[: last_brace_index + 1] + return json.loads(maybe_fixed_json) + except (json.JSONDecodeError, ValueError) as e: + return try_ai_fix(try_to_fix_with_gpt, e, json_to_load) + + +def try_ai_fix( + try_to_fix_with_gpt: bool, exception: Exception, json_to_load: str +) -> Union[str, Dict[Any, Any]]: + """Try to fix the JSON with the AI + + Args: + try_to_fix_with_gpt (bool): Whether to try to fix the JSON with the AI. + exception (Exception): The exception that was raised. + json_to_load (str): The JSON string to load. + + Raises: + exception: If try_to_fix_with_gpt is False. + + Returns: + Union[str, Dict[Any, Any]]: The JSON string or dictionary. + """ + if not try_to_fix_with_gpt: + raise exception + + logger.warn( + "Warning: Failed to parse AI output, attempting to fix." + "\n If you see this warning frequently, it's likely that" + " your prompt is confusing the AI. Try changing it up" + " slightly." + ) + # Now try to fix this up using the ai_functions + ai_fixed_json = fix_json(json_to_load, JSON_SCHEMA) + + if ai_fixed_json != "failed": + return json.loads(ai_fixed_json) + # This allows the AI to react to the error message, + # which usually results in it correcting its ways. + logger.error("Failed to fix AI output, telling the AI.") + return json_to_load diff --git a/autogpt/json_fixes/utilities.py b/autogpt/json_fixes/utilities.py new file mode 100644 index 00000000..0852b18a --- /dev/null +++ b/autogpt/json_fixes/utilities.py @@ -0,0 +1,20 @@ +"""Utilities for the json_fixes package.""" +import re + + +def extract_char_position(error_message: str) -> int: + """Extract the character position from the JSONDecodeError message. + + Args: + error_message (str): The error message from the JSONDecodeError + exception. + + Returns: + int: The character position. + """ + + char_pattern = re.compile(r"\(char (\d+)\)") + if match := char_pattern.search(error_message): + return int(match[1]) + else: + raise ValueError("Character position not found in the error message.") diff --git a/autogpt/json_parser.py b/autogpt/json_parser.py deleted file mode 100644 index b32146da..00000000 --- a/autogpt/json_parser.py +++ /dev/null @@ -1,113 +0,0 @@ -import json -from typing import Any, Dict, Union - -from autogpt.call_ai_function import call_ai_function -from autogpt.config import Config -from autogpt.json_utils import correct_json -from autogpt.logger import logger - -cfg = Config() - -JSON_SCHEMA = """ -{ - "command": { - "name": "command name", - "args": { - "arg name": "value" - } - }, - "thoughts": - { - "text": "thought", - "reasoning": "reasoning", - "plan": "- short bulleted\n- list that conveys\n- long-term plan", - "criticism": "constructive self-criticism", - "speak": "thoughts summary to say to user" - } -} -""" - - -def fix_and_parse_json( - json_str: str, try_to_fix_with_gpt: bool = True -) -> Union[str, Dict[Any, Any]]: - """Fix and parse JSON string""" - try: - json_str = json_str.replace("\t", "") - return json.loads(json_str) - except json.JSONDecodeError as _: # noqa: F841 - try: - json_str = correct_json(json_str) - return json.loads(json_str) - except json.JSONDecodeError as _: # noqa: F841 - pass - # Let's do something manually: - # sometimes GPT responds with something BEFORE the braces: - # "I'm sorry, I don't understand. Please try again." - # {"text": "I'm sorry, I don't understand. Please try again.", - # "confidence": 0.0} - # So let's try to find the first brace and then parse the rest - # of the string - try: - brace_index = json_str.index("{") - json_str = json_str[brace_index:] - last_brace_index = json_str.rindex("}") - json_str = json_str[: last_brace_index + 1] - return json.loads(json_str) - # Can throw a ValueError if there is no "{" or "}" in the json_str - except (json.JSONDecodeError, ValueError) as e: # noqa: F841 - if try_to_fix_with_gpt: - logger.warn( - "Warning: Failed to parse AI output, attempting to fix." - "\n If you see this warning frequently, it's likely that" - " your prompt is confusing the AI. Try changing it up" - " slightly." - ) - # Now try to fix this up using the ai_functions - ai_fixed_json = fix_json(json_str, JSON_SCHEMA) - - if ai_fixed_json != "failed": - return json.loads(ai_fixed_json) - else: - # This allows the AI to react to the error message, - # which usually results in it correcting its ways. - logger.error("Failed to fix AI output, telling the AI.") - return json_str - else: - raise e - - -def fix_json(json_str: str, schema: str) -> str: - """Fix the given JSON string to make it parseable and fully compliant with the provided schema.""" - # Try to fix the JSON using GPT: - function_string = "def fix_json(json_str: str, schema:str=None) -> str:" - args = [f"'''{json_str}'''", f"'''{schema}'''"] - description_string = ( - "Fixes the provided JSON string to make it parseable" - " and fully compliant with the provided schema.\n If an object or" - " field specified in the schema isn't contained within the correct" - " JSON, it is omitted.\n This function is brilliant at guessing" - " when the format is incorrect." - ) - - # If it doesn't already start with a "`", add one: - if not json_str.startswith("`"): - json_str = "```json\n" + json_str + "\n```" - result_string = call_ai_function( - function_string, args, description_string, model=cfg.fast_llm_model - ) - logger.debug("------------ JSON FIX ATTEMPT ---------------") - logger.debug(f"Original JSON: {json_str}") - logger.debug("-----------") - logger.debug(f"Fixed JSON: {result_string}") - logger.debug("----------- END OF FIX ATTEMPT ----------------") - - try: - json.loads(result_string) # just check the validity - return result_string - except: # noqa: E722 - # Get the call stack: - # import traceback - # call_stack = traceback.format_exc() - # print(f"Failed to fix JSON: '{json_str}' "+call_stack) - return "failed" diff --git a/autogpt/json_utils.py b/autogpt/json_utils.py deleted file mode 100644 index 848f9fff..00000000 --- a/autogpt/json_utils.py +++ /dev/null @@ -1,128 +0,0 @@ -import json -import re -from typing import Optional - -from autogpt.config import Config - -cfg = Config() - - -def extract_char_position(error_message: str) -> int: - """Extract the character position from the JSONDecodeError message. - - Args: - error_message (str): The error message from the JSONDecodeError - exception. - - Returns: - int: The character position. - """ - import re - - char_pattern = re.compile(r"\(char (\d+)\)") - if match := char_pattern.search(error_message): - return int(match[1]) - else: - raise ValueError("Character position not found in the error message.") - - -def add_quotes_to_property_names(json_string: str) -> str: - """ - Add quotes to property names in a JSON string. - - Args: - json_string (str): The JSON string. - - Returns: - str: The JSON string with quotes added to property names. - """ - - def replace_func(match): - return f'"{match.group(1)}":' - - property_name_pattern = re.compile(r"(\w+):") - corrected_json_string = property_name_pattern.sub(replace_func, json_string) - - try: - json.loads(corrected_json_string) - return corrected_json_string - except json.JSONDecodeError as e: - raise e - - -def balance_braces(json_string: str) -> Optional[str]: - """ - Balance the braces in a JSON string. - - Args: - json_string (str): The JSON string. - - Returns: - str: The JSON string with braces balanced. - """ - - open_braces_count = json_string.count("{") - close_braces_count = json_string.count("}") - - while open_braces_count > close_braces_count: - json_string += "}" - close_braces_count += 1 - - while close_braces_count > open_braces_count: - json_string = json_string.rstrip("}") - close_braces_count -= 1 - - try: - json.loads(json_string) - return json_string - except json.JSONDecodeError: - pass - - -def fix_invalid_escape(json_str: str, error_message: str) -> str: - while error_message.startswith("Invalid \\escape"): - bad_escape_location = extract_char_position(error_message) - json_str = json_str[:bad_escape_location] + json_str[bad_escape_location + 1 :] - try: - json.loads(json_str) - return json_str - except json.JSONDecodeError as e: - if cfg.debug_mode: - print("json loads error - fix invalid escape", e) - error_message = str(e) - return json_str - - -def correct_json(json_str: str) -> str: - """ - Correct common JSON errors. - - Args: - json_str (str): The JSON string. - """ - - try: - if cfg.debug_mode: - print("json", json_str) - json.loads(json_str) - return json_str - except json.JSONDecodeError as e: - if cfg.debug_mode: - print("json loads error", e) - error_message = str(e) - if error_message.startswith("Invalid \\escape"): - json_str = fix_invalid_escape(json_str, error_message) - if error_message.startswith( - "Expecting property name enclosed in double quotes" - ): - json_str = add_quotes_to_property_names(json_str) - try: - json.loads(json_str) - return json_str - except json.JSONDecodeError as e: - if cfg.debug_mode: - print("json loads error - add quotes", e) - error_message = str(e) - if balanced_str := balance_braces(json_str): - return balanced_str - return json_str diff --git a/autogpt/llm_utils.py b/autogpt/llm_utils.py index 7503dc44..f2418b65 100644 --- a/autogpt/llm_utils.py +++ b/autogpt/llm_utils.py @@ -1,4 +1,6 @@ +from ast import List import time +from typing import Dict, Optional import openai from openai.error import APIError, RateLimitError @@ -6,30 +8,79 @@ from colorama import Fore from autogpt.config import Config -cfg = Config() +CFG = Config() -openai.api_key = cfg.openai_api_key +openai.api_key = CFG.openai_api_key + + +def call_ai_function( + function: str, args: List, description: str, model: Optional[str] = None +) -> str: + """Call an AI function + + This is a magic function that can do anything with no-code. See + https://github.com/Torantulino/AI-Functions for more info. + + Args: + function (str): The function to call + args (list): The arguments to pass to the function + description (str): The description of the function + model (str, optional): The model to use. Defaults to None. + + Returns: + str: The response from the function + """ + if model is None: + model = CFG.smart_llm_model + # For each arg, if any are None, convert to "None": + args = [str(arg) if arg is not None else "None" for arg in args] + # parse args to comma separated string + args = ", ".join(args) + messages = [ + { + "role": "system", + "content": f"You are now the following python function: ```# {description}" + f"\n{function}```\n\nOnly respond with your `return` value.", + }, + {"role": "user", "content": args}, + ] + + return create_chat_completion(model=model, messages=messages, temperature=0) # Overly simple abstraction until we create something better # simple retry mechanism when getting a rate error or a bad gateway def create_chat_completion( - messages, model=None, temperature=cfg.temperature, max_tokens=None + messages: List, # type: ignore + model: Optional[str] = None, + temperature: float = CFG.temperature, + max_tokens: Optional[int] = None, ) -> str: - """Create a chat completion using the OpenAI API""" + """Create a chat completion using the OpenAI API + + Args: + messages (list[dict[str, str]]): The messages to send to the chat completion + model (str, optional): The model to use. Defaults to None. + temperature (float, optional): The temperature to use. Defaults to 0.9. + max_tokens (int, optional): The max tokens to use. Defaults to None. + + Returns: + str: The response from the chat completion + """ response = None - num_retries = 5 - if cfg.debug_mode: + num_retries = 10 + if CFG.debug_mode: print( Fore.GREEN + f"Creating chat completion with model {model}, temperature {temperature}," f" max_tokens {max_tokens}" + Fore.RESET ) for attempt in range(num_retries): + backoff = 2 ** (attempt + 2) try: - if cfg.use_azure: + if CFG.use_azure: response = openai.ChatCompletion.create( - deployment_id=cfg.get_azure_deployment_id_for_model(model), + deployment_id=CFG.get_azure_deployment_id_for_model(model), model=model, messages=messages, temperature=temperature, @@ -44,26 +95,21 @@ def create_chat_completion( ) break except RateLimitError: - if cfg.debug_mode: - print( - Fore.RED + "Error: ", - "API Rate Limit Reached. Waiting 20 seconds..." + Fore.RESET, - ) - time.sleep(20) + pass except APIError as e: if e.http_status == 502: - if cfg.debug_mode: - print( - Fore.RED + "Error: ", - "API Bad gateway. Waiting 20 seconds..." + Fore.RESET, - ) - time.sleep(20) + pass else: raise if attempt == num_retries - 1: raise - + if CFG.debug_mode: + print( + Fore.RED + "Error: ", + f"API Bad gateway. Waiting {backoff} seconds..." + Fore.RESET, + ) + time.sleep(backoff) if response is None: - raise RuntimeError("Failed to get response after 5 retries") + raise RuntimeError(f"Failed to get response after {num_retries} retries") return response.choices[0].message["content"] diff --git a/autogpt/logger.py b/autogpt/logs.py similarity index 59% rename from autogpt/logger.py rename to autogpt/logs.py index 1b58fdff..a34d89b1 100644 --- a/autogpt/logger.py +++ b/autogpt/logs.py @@ -1,25 +1,28 @@ +"""Logging module for Auto-GPT.""" +import json import logging import os import random import re import time from logging import LogRecord +import traceback from colorama import Fore, Style -from autogpt import speak +from autogpt.speech import say_text from autogpt.config import Config, Singleton -cfg = Config() - -""" -Logger that handle titles in different colors. -Outputs logs in console, activity.log, and errors.log -For console handler: simulates typing -""" +CFG = Config() class Logger(metaclass=Singleton): + """ + Logger that handle titles in different colors. + Outputs logs in console, activity.log, and errors.log + For console handler: simulates typing + """ + def __init__(self): # create log directory if it doesn't exist this_files_dir_path = os.path.dirname(__file__) @@ -74,8 +77,8 @@ class Logger(metaclass=Singleton): def typewriter_log( self, title="", title_color="", content="", speak_text=False, level=logging.INFO ): - if speak_text and cfg.speak_mode: - speak.say_text(f"{title}. {content}") + if speak_text and CFG.speak_mode: + say_text(f"{title}. {content}") if content: if isinstance(content, list): @@ -193,3 +196,93 @@ def remove_color_codes(s: str) -> str: logger = Logger() + + +def print_assistant_thoughts(ai_name, assistant_reply): + """Prints the assistant's thoughts to the console""" + from autogpt.json_fixes.bracket_termination import ( + attempt_to_fix_json_by_finding_outermost_brackets, + ) + from autogpt.json_fixes.parsing import fix_and_parse_json + + try: + try: + # Parse and print Assistant response + assistant_reply_json = fix_and_parse_json(assistant_reply) + except json.JSONDecodeError: + logger.error("Error: Invalid JSON in assistant thoughts\n", assistant_reply) + assistant_reply_json = attempt_to_fix_json_by_finding_outermost_brackets( + assistant_reply + ) + if isinstance(assistant_reply_json, str): + assistant_reply_json = fix_and_parse_json(assistant_reply_json) + + # Check if assistant_reply_json is a string and attempt to parse + # it into a JSON object + if isinstance(assistant_reply_json, str): + try: + assistant_reply_json = json.loads(assistant_reply_json) + except json.JSONDecodeError: + logger.error("Error: Invalid JSON\n", assistant_reply) + assistant_reply_json = ( + attempt_to_fix_json_by_finding_outermost_brackets( + assistant_reply_json + ) + ) + + assistant_thoughts_reasoning = None + assistant_thoughts_plan = None + assistant_thoughts_speak = None + assistant_thoughts_criticism = None + if not isinstance(assistant_reply_json, dict): + assistant_reply_json = {} + assistant_thoughts = assistant_reply_json.get("thoughts", {}) + assistant_thoughts_text = assistant_thoughts.get("text") + + if assistant_thoughts: + assistant_thoughts_reasoning = assistant_thoughts.get("reasoning") + assistant_thoughts_plan = assistant_thoughts.get("plan") + assistant_thoughts_criticism = assistant_thoughts.get("criticism") + assistant_thoughts_speak = assistant_thoughts.get("speak") + + logger.typewriter_log( + f"{ai_name.upper()} THOUGHTS:", Fore.YELLOW, f"{assistant_thoughts_text}" + ) + logger.typewriter_log( + "REASONING:", Fore.YELLOW, f"{assistant_thoughts_reasoning}" + ) + + if assistant_thoughts_plan: + logger.typewriter_log("PLAN:", Fore.YELLOW, "") + # If it's a list, join it into a string + if isinstance(assistant_thoughts_plan, list): + assistant_thoughts_plan = "\n".join(assistant_thoughts_plan) + elif isinstance(assistant_thoughts_plan, dict): + assistant_thoughts_plan = str(assistant_thoughts_plan) + + # Split the input_string using the newline character and dashes + lines = assistant_thoughts_plan.split("\n") + for line in lines: + line = line.lstrip("- ") + logger.typewriter_log("- ", Fore.GREEN, line.strip()) + + logger.typewriter_log( + "CRITICISM:", Fore.YELLOW, f"{assistant_thoughts_criticism}" + ) + # Speak the assistant's thoughts + if CFG.speak_mode and assistant_thoughts_speak: + say_text(assistant_thoughts_speak) + + return assistant_reply_json + except json.decoder.JSONDecodeError: + logger.error("Error: Invalid JSON\n", assistant_reply) + if CFG.speak_mode: + say_text( + "I have received an invalid JSON response from the OpenAI API." + " I cannot ignore this response." + ) + + # All other errors, return "Error: + error message" + except Exception: + call_stack = traceback.format_exc() + logger.error("Error: \n", call_stack) diff --git a/autogpt/memory/local.py b/autogpt/memory/local.py index 67f040ae..a5f6076e 100644 --- a/autogpt/memory/local.py +++ b/autogpt/memory/local.py @@ -1,6 +1,6 @@ import dataclasses import os -from typing import Any, List, Optional +from typing import Any, List, Optional, Tuple import numpy as np import orjson @@ -24,8 +24,17 @@ class CacheContent: class LocalCache(MemoryProviderSingleton): - # on load, load our database + """A class that stores the memory in a local file""" + def __init__(self, cfg) -> None: + """Initialize a class instance + + Args: + cfg: Config object + + Returns: + None + """ self.filename = f"{cfg.memory_index}.json" if os.path.exists(self.filename): try: @@ -42,7 +51,8 @@ class LocalCache(MemoryProviderSingleton): self.data = CacheContent() else: print( - f"Warning: The file '{self.filename}' does not exist. Local memory would not be saved to a file." + f"Warning: The file '{self.filename}' does not exist." + "Local memory would not be saved to a file." ) self.data = CacheContent() @@ -116,7 +126,7 @@ class LocalCache(MemoryProviderSingleton): return [self.data.texts[i] for i in top_k_indices] - def get_stats(self): + def get_stats(self) -> Tuple[int, Tuple[int, ...]]: """ Returns: The stats of the local cache. """ diff --git a/autogpt/memory/no_memory.py b/autogpt/memory/no_memory.py index 37f00085..0a976690 100644 --- a/autogpt/memory/no_memory.py +++ b/autogpt/memory/no_memory.py @@ -1,9 +1,14 @@ +"""A class that does not store any data. This is the default memory provider.""" from typing import Optional, List, Any from autogpt.memory.base import MemoryProviderSingleton class NoMemory(MemoryProviderSingleton): + """ + A class that does not store any data. This is the default memory provider. + """ + def __init__(self, cfg): """ Initializes the NoMemory provider. diff --git a/autogpt/memory/pinecone.py b/autogpt/memory/pinecone.py index 4e302f6e..a7dbfa82 100644 --- a/autogpt/memory/pinecone.py +++ b/autogpt/memory/pinecone.py @@ -1,7 +1,7 @@ import pinecone from colorama import Fore, Style -from autogpt.logger import logger +from autogpt.logs import logger from autogpt.memory.base import MemoryProviderSingleton, get_ada_embedding @@ -16,7 +16,8 @@ class PineconeMemory(MemoryProviderSingleton): table_name = "auto-gpt" # this assumes we don't start with memory. # for now this works. - # we'll need a more complicated and robust system if we want to start with memory. + # we'll need a more complicated and robust system if we want to start with + # memory. self.vec_num = 0 try: @@ -28,8 +29,10 @@ class PineconeMemory(MemoryProviderSingleton): Style.BRIGHT + str(e) + Style.RESET_ALL, ) logger.double_check( - "Please ensure you have setup and configured Pinecone properly for use. " - + f"You can check out {Fore.CYAN + Style.BRIGHT}https://github.com/Torantulino/Auto-GPT#-pinecone-api-key-setup{Style.RESET_ALL} to ensure you've set up everything correctly." + "Please ensure you have setup and configured Pinecone properly for use." + + f"You can check out {Fore.CYAN + Style.BRIGHT}" + "https://github.com/Torantulino/Auto-GPT#-pinecone-api-key-setup" + f"{Style.RESET_ALL} to ensure you've set up everything correctly." ) exit(1) @@ -42,7 +45,7 @@ class PineconeMemory(MemoryProviderSingleton): def add(self, data): vector = get_ada_embedding(data) # no metadata here. We may wish to change that long term. - resp = self.index.upsert([(str(self.vec_num), vector, {"raw_text": data})]) + self.index.upsert([(str(self.vec_num), vector, {"raw_text": data})]) _text = f"Inserting data into memory at index: {self.vec_num}:\n data: {data}" self.vec_num += 1 return _text diff --git a/autogpt/memory/redismem.py b/autogpt/memory/redismem.py index d36594ba..df6d8fc0 100644 --- a/autogpt/memory/redismem.py +++ b/autogpt/memory/redismem.py @@ -8,7 +8,7 @@ from redis.commands.search.field import TextField, VectorField from redis.commands.search.indexDefinition import IndexDefinition, IndexType from redis.commands.search.query import Query -from autogpt.logger import logger +from autogpt.logs import logger from autogpt.memory.base import MemoryProviderSingleton, get_ada_embedding SCHEMA = [ @@ -54,7 +54,9 @@ class RedisMemory(MemoryProviderSingleton): ) logger.double_check( "Please ensure you have setup and configured Redis properly for use. " - + f"You can check out {Fore.CYAN + Style.BRIGHT}https://github.com/Torantulino/Auto-GPT#redis-setup{Style.RESET_ALL} to ensure you've set up everything correctly." + + f"You can check out {Fore.CYAN + Style.BRIGHT}" + f"https://github.com/Torantulino/Auto-GPT#redis-setup{Style.RESET_ALL}" + " to ensure you've set up everything correctly." ) exit(1) diff --git a/autogpt/processing/__init__.py b/autogpt/processing/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/autogpt/processing/text.py b/autogpt/processing/text.py new file mode 100644 index 00000000..24e3bb85 --- /dev/null +++ b/autogpt/processing/text.py @@ -0,0 +1,132 @@ +"""Text processing functions""" +from typing import Generator, Optional +from selenium.webdriver.remote.webdriver import WebDriver +from autogpt.memory import get_memory +from autogpt.config import Config +from autogpt.llm_utils import create_chat_completion + +CFG = Config() +MEMORY = get_memory(CFG) + + +def split_text(text: str, max_length: int = 8192) -> Generator[str, None, None]: + """Split text into chunks of a maximum length + + Args: + text (str): The text to split + max_length (int, optional): The maximum length of each chunk. Defaults to 8192. + + Yields: + str: The next chunk of text + + Raises: + ValueError: If the text is longer than the maximum length + """ + paragraphs = text.split("\n") + current_length = 0 + current_chunk = [] + + for paragraph in paragraphs: + if current_length + len(paragraph) + 1 <= max_length: + current_chunk.append(paragraph) + current_length += len(paragraph) + 1 + else: + yield "\n".join(current_chunk) + current_chunk = [paragraph] + current_length = len(paragraph) + 1 + + if current_chunk: + yield "\n".join(current_chunk) + + +def summarize_text( + url: str, text: str, question: str, driver: Optional[WebDriver] = None +) -> str: + """Summarize text using the OpenAI API + + Args: + url (str): The url of the text + text (str): The text to summarize + question (str): The question to ask the model + driver (WebDriver): The webdriver to use to scroll the page + + Returns: + str: The summary of the text + """ + if not text: + return "Error: No text to summarize" + + text_length = len(text) + print(f"Text length: {text_length} characters") + + summaries = [] + chunks = list(split_text(text)) + scroll_ratio = 1 / len(chunks) + + for i, chunk in enumerate(chunks): + if driver: + scroll_to_percentage(driver, scroll_ratio * i) + print(f"Adding chunk {i + 1} / {len(chunks)} to memory") + + memory_to_add = f"Source: {url}\n" f"Raw content part#{i + 1}: {chunk}" + + MEMORY.add(memory_to_add) + + print(f"Summarizing chunk {i + 1} / {len(chunks)}") + messages = [create_message(chunk, question)] + + summary = create_chat_completion( + model=CFG.fast_llm_model, + messages=messages, + max_tokens=CFG.browse_summary_max_token, + ) + summaries.append(summary) + print(f"Added chunk {i + 1} summary to memory") + + memory_to_add = f"Source: {url}\n" f"Content summary part#{i + 1}: {summary}" + + MEMORY.add(memory_to_add) + + print(f"Summarized {len(chunks)} chunks.") + + combined_summary = "\n".join(summaries) + messages = [create_message(combined_summary, question)] + + return create_chat_completion( + model=CFG.fast_llm_model, + messages=messages, + max_tokens=CFG.browse_summary_max_token, + ) + + +def scroll_to_percentage(driver: WebDriver, ratio: float) -> None: + """Scroll to a percentage of the page + + Args: + driver (WebDriver): The webdriver to use + ratio (float): The percentage to scroll to + + Raises: + ValueError: If the ratio is not between 0 and 1 + """ + if ratio < 0 or ratio > 1: + raise ValueError("Percentage should be between 0 and 1") + driver.execute_script(f"window.scrollTo(0, document.body.scrollHeight * {ratio});") + + +def create_message(chunk: str, question: str) -> dict[str, str]: + """Create a message for the chat completion + + Args: + chunk (str): The chunk of text to summarize + question (str): The question to answer + + Returns: + dict[str, str]: The message to send to the chat completion + """ + return { + "role": "user", + "content": f'"""{chunk}""" Using the above text, please answer the following' + f' question: "{question}" -- if the question cannot be answered using the text,' + " please summarize the text.", + } diff --git a/autogpt/prompt.py b/autogpt/prompt.py index e41312c7..050c2560 100644 --- a/autogpt/prompt.py +++ b/autogpt/prompt.py @@ -1,4 +1,12 @@ +from colorama import Fore +from autogpt.config.ai_config import AIConfig +from autogpt.config.config import Config +from autogpt.logs import logger from autogpt.promptgenerator import PromptGenerator +from autogpt.setup import prompt_user +from autogpt.utils import clean_input + +CFG = Config() def get_prompt() -> str: @@ -106,3 +114,42 @@ def get_prompt() -> str: # Generate the prompt string return prompt_generator.generate_prompt_string() + + +def construct_prompt() -> str: + """Construct the prompt for the AI to respond to + + Returns: + str: The prompt string + """ + config = AIConfig.load(CFG.ai_settings_file) + if CFG.skip_reprompt and config.ai_name: + logger.typewriter_log("Name :", Fore.GREEN, config.ai_name) + logger.typewriter_log("Role :", Fore.GREEN, config.ai_role) + logger.typewriter_log("Goals:", Fore.GREEN, f"{config.ai_goals}") + elif config.ai_name: + logger.typewriter_log( + "Welcome back! ", + Fore.GREEN, + f"Would you like me to return to being {config.ai_name}?", + speak_text=True, + ) + should_continue = clean_input( + f"""Continue with the last settings? +Name: {config.ai_name} +Role: {config.ai_role} +Goals: {config.ai_goals} +Continue (y/n): """ + ) + if should_continue.lower() == "n": + config = AIConfig() + + if not config.ai_name: + config = prompt_user() + config.save() + + # Get rid of this global: + global ai_name + ai_name = config.ai_name + + return config.construct_full_prompt() diff --git a/autogpt/promptgenerator.py b/autogpt/promptgenerator.py index d6802cec..82dba8e0 100644 --- a/autogpt/promptgenerator.py +++ b/autogpt/promptgenerator.py @@ -1,4 +1,6 @@ +""" A module for generating custom prompt strings.""" import json +from typing import Any, Dict, List class PromptGenerator: @@ -7,7 +9,7 @@ class PromptGenerator: resources, and performance evaluations. """ - def __init__(self): + def __init__(self) -> None: """ Initialize the PromptGenerator object with empty lists of constraints, commands, resources, and performance evaluations. @@ -27,7 +29,7 @@ class PromptGenerator: "command": {"name": "command name", "args": {"arg name": "value"}}, } - def add_constraint(self, constraint): + def add_constraint(self, constraint: str) -> None: """ Add a constraint to the constraints list. @@ -36,7 +38,7 @@ class PromptGenerator: """ self.constraints.append(constraint) - def add_command(self, command_label, command_name, args=None): + def add_command(self, command_label: str, command_name: str, args=None) -> None: """ Add a command to the commands list with a label, name, and optional arguments. @@ -59,7 +61,7 @@ class PromptGenerator: self.commands.append(command) - def _generate_command_string(self, command): + def _generate_command_string(self, command: Dict[str, Any]) -> str: """ Generate a formatted string representation of a command. @@ -92,7 +94,7 @@ class PromptGenerator: """ self.performance_evaluation.append(evaluation) - def _generate_numbered_list(self, items, item_type="list") -> str: + def _generate_numbered_list(self, items: List[Any], item_type="list") -> str: """ Generate a numbered list from given items based on the item_type. diff --git a/autogpt/setup.py b/autogpt/setup.py new file mode 100644 index 00000000..5315c01d --- /dev/null +++ b/autogpt/setup.py @@ -0,0 +1,69 @@ +"""Setup the AI and its goals""" +from colorama import Fore, Style +from autogpt import utils +from autogpt.config.ai_config import AIConfig +from autogpt.logs import logger + + +def prompt_user() -> AIConfig: + """Prompt the user for input + + Returns: + AIConfig: The AIConfig object containing the user's input + """ + ai_name = "" + # Construct the prompt + logger.typewriter_log( + "Welcome to Auto-GPT! ", + Fore.GREEN, + "Enter the name of your AI and its role below. Entering nothing will load" + " defaults.", + speak_text=True, + ) + + # Get AI Name from User + logger.typewriter_log( + "Name your AI: ", Fore.GREEN, "For example, 'Entrepreneur-GPT'" + ) + ai_name = utils.clean_input("AI Name: ") + if ai_name == "": + ai_name = "Entrepreneur-GPT" + + logger.typewriter_log( + f"{ai_name} here!", Fore.LIGHTBLUE_EX, "I am at your service.", speak_text=True + ) + + # Get AI Role from User + logger.typewriter_log( + "Describe your AI's role: ", + Fore.GREEN, + "For example, 'an AI designed to autonomously develop and run businesses with" + " the sole goal of increasing your net worth.'", + ) + ai_role = utils.clean_input(f"{ai_name} is: ") + if ai_role == "": + ai_role = "an AI designed to autonomously develop and run businesses with the" + " sole goal of increasing your net worth." + + # Enter up to 5 goals for the AI + logger.typewriter_log( + "Enter up to 5 goals for your AI: ", + Fore.GREEN, + "For example: \nIncrease net worth, Grow Twitter Account, Develop and manage" + " multiple businesses autonomously'", + ) + print("Enter nothing to load defaults, enter nothing when finished.", flush=True) + ai_goals = [] + for i in range(5): + ai_goal = utils.clean_input(f"{Fore.LIGHTBLUE_EX}Goal{Style.RESET_ALL} {i+1}: ") + if ai_goal == "": + break + ai_goals.append(ai_goal) + if not ai_goals: + ai_goals = [ + "Increase net worth", + "Grow Twitter Account", + "Develop and manage multiple businesses autonomously", + ] + + return AIConfig(ai_name, ai_role, ai_goals) diff --git a/autogpt/speak.py b/autogpt/speak.py deleted file mode 100644 index 41b3ac9f..00000000 --- a/autogpt/speak.py +++ /dev/null @@ -1,120 +0,0 @@ -import os - -import requests -from playsound import playsound - -from autogpt.config import Config - -import threading -from threading import Lock, Semaphore - -import gtts - -cfg = Config() - -# Default voice IDs -default_voices = ["ErXwobaYiN019PkySvjV", "EXAVITQu4vr4xnSDxMaL"] - -# Retrieve custom voice IDs from the Config class -custom_voice_1 = cfg.elevenlabs_voice_1_id -custom_voice_2 = cfg.elevenlabs_voice_2_id - -# Placeholder values that should be treated as empty -placeholders = {"your-voice-id"} - -# Use custom voice IDs if provided and not placeholders, otherwise use default voice IDs -voices = [ - custom_voice_1 - if custom_voice_1 and custom_voice_1 not in placeholders - else default_voices[0], - custom_voice_2 - if custom_voice_2 and custom_voice_2 not in placeholders - else default_voices[1], -] - -tts_headers = {"Content-Type": "application/json", "xi-api-key": cfg.elevenlabs_api_key} - -mutex_lock = Lock() # Ensure only one sound is played at a time -queue_semaphore = Semaphore( - 1 -) # The amount of sounds to queue before blocking the main thread - - -def eleven_labs_speech(text, voice_index=0): - """Speak text using elevenlabs.io's API""" - tts_url = "https://api.elevenlabs.io/v1/text-to-speech/{voice_id}".format( - voice_id=voices[voice_index] - ) - formatted_message = {"text": text} - response = requests.post(tts_url, headers=tts_headers, json=formatted_message) - - if response.status_code == 200: - with mutex_lock: - with open("speech.mpeg", "wb") as f: - f.write(response.content) - playsound("speech.mpeg", True) - os.remove("speech.mpeg") - return True - else: - print("Request failed with status code:", response.status_code) - print("Response content:", response.content) - return False - - -def brian_speech(text): - """Speak text using Brian with the streamelements API""" - tts_url = f"https://api.streamelements.com/kappa/v2/speech?voice=Brian&text={text}" - response = requests.get(tts_url) - - if response.status_code == 200: - with mutex_lock: - with open("speech.mp3", "wb") as f: - f.write(response.content) - playsound("speech.mp3") - os.remove("speech.mp3") - return True - else: - print("Request failed with status code:", response.status_code) - print("Response content:", response.content) - return False - - -def gtts_speech(text): - tts = gtts.gTTS(text) - with mutex_lock: - tts.save("speech.mp3") - playsound("speech.mp3", True) - os.remove("speech.mp3") - - -def macos_tts_speech(text, voice_index=0): - if voice_index == 0: - os.system(f'say "{text}"') - else: - if voice_index == 1: - os.system(f'say -v "Ava (Premium)" "{text}"') - else: - os.system(f'say -v Samantha "{text}"') - - -def say_text(text, voice_index=0): - def speak(): - if not cfg.elevenlabs_api_key: - if cfg.use_mac_os_tts == "True": - macos_tts_speech(text) - elif cfg.use_brian_tts == "True": - success = brian_speech(text) - if not success: - gtts_speech(text) - else: - gtts_speech(text) - else: - success = eleven_labs_speech(text, voice_index) - if not success: - gtts_speech(text) - - queue_semaphore.release() - - queue_semaphore.acquire(True) - thread = threading.Thread(target=speak) - thread.start() diff --git a/autogpt/speech/__init__.py b/autogpt/speech/__init__.py new file mode 100644 index 00000000..2ff0d2bf --- /dev/null +++ b/autogpt/speech/__init__.py @@ -0,0 +1,4 @@ +"""This module contains the speech recognition and speech synthesis functions.""" +from autogpt.speech.say import say_text + +__all__ = ["say_text"] diff --git a/autogpt/speech/base.py b/autogpt/speech/base.py new file mode 100644 index 00000000..d74fa51b --- /dev/null +++ b/autogpt/speech/base.py @@ -0,0 +1,50 @@ +"""Base class for all voice classes.""" +import abc +from threading import Lock + +from autogpt.config import AbstractSingleton + + +class VoiceBase(AbstractSingleton): + """ + Base class for all voice classes. + """ + + def __init__(self): + """ + Initialize the voice class. + """ + self._url = None + self._headers = None + self._api_key = None + self._voices = [] + self._mutex = Lock() + self._setup() + + def say(self, text: str, voice_index: int = 0) -> bool: + """ + Say the given text. + + Args: + text (str): The text to say. + voice_index (int): The index of the voice to use. + """ + with self._mutex: + return self._speech(text, voice_index) + + @abc.abstractmethod + def _setup(self) -> None: + """ + Setup the voices, API key, etc. + """ + pass + + @abc.abstractmethod + def _speech(self, text: str, voice_index: int = 0) -> bool: + """ + Play the given text. + + Args: + text (str): The text to play. + """ + pass diff --git a/autogpt/speech/brian.py b/autogpt/speech/brian.py new file mode 100644 index 00000000..e581bbcc --- /dev/null +++ b/autogpt/speech/brian.py @@ -0,0 +1,39 @@ +""" Brian speech module for autogpt """ +import os +import requests +from playsound import playsound + +from autogpt.speech.base import VoiceBase + + +class BrianSpeech(VoiceBase): + """Brian speech module for autogpt""" + + def _setup(self) -> None: + """Setup the voices, API key, etc.""" + pass + + def _speech(self, text: str) -> bool: + """Speak text using Brian with the streamelements API + + Args: + text (str): The text to speak + + Returns: + bool: True if the request was successful, False otherwise + """ + tts_url = ( + f"https://api.streamelements.com/kappa/v2/speech?voice=Brian&text={text}" + ) + response = requests.get(tts_url) + + if response.status_code == 200: + with open("speech.mp3", "wb") as f: + f.write(response.content) + playsound("speech.mp3") + os.remove("speech.mp3") + return True + else: + print("Request failed with status code:", response.status_code) + print("Response content:", response.content) + return False diff --git a/autogpt/speech/eleven_labs.py b/autogpt/speech/eleven_labs.py new file mode 100644 index 00000000..2c54ffad --- /dev/null +++ b/autogpt/speech/eleven_labs.py @@ -0,0 +1,71 @@ +"""ElevenLabs speech module""" +import os +from playsound import playsound + +import requests + +from autogpt.config import Config +from autogpt.speech.base import VoiceBase + +PLACEHOLDERS = {"your-voice-id"} + + +class ElevenLabsSpeech(VoiceBase): + """ElevenLabs speech class""" + + def _setup(self) -> None: + """Setup the voices, API key, etc. + + Returns: + None: None + """ + + cfg = Config() + default_voices = ["ErXwobaYiN019PkySvjV", "EXAVITQu4vr4xnSDxMaL"] + self._headers = { + "Content-Type": "application/json", + "xi-api-key": cfg.elevenlabs_api_key, + } + self._voices = default_voices.copy() + self._use_custom_voice(cfg.elevenlabs_voice_1_id, 0) + self._use_custom_voice(cfg.elevenlabs_voice_2_id, 1) + + def _use_custom_voice(self, voice, voice_index) -> None: + """Use a custom voice if provided and not a placeholder + + Args: + voice (str): The voice ID + voice_index (int): The voice index + + Returns: + None: None + """ + # Placeholder values that should be treated as empty + if voice and voice not in PLACEHOLDERS: + self._voices[voice_index] = voice + + def _speech(self, text: str, voice_index: int = 0) -> bool: + """Speak text using elevenlabs.io's API + + Args: + text (str): The text to speak + voice_index (int, optional): The voice to use. Defaults to 0. + + Returns: + bool: True if the request was successful, False otherwise + """ + tts_url = ( + f"https://api.elevenlabs.io/v1/text-to-speech/{self._voices[voice_index]}" + ) + response = requests.post(tts_url, headers=self._headers, json={"text": text}) + + if response.status_code == 200: + with open("speech.mpeg", "wb") as f: + f.write(response.content) + playsound("speech.mpeg", True) + os.remove("speech.mpeg") + return True + else: + print("Request failed with status code:", response.status_code) + print("Response content:", response.content) + return False diff --git a/autogpt/speech/gtts.py b/autogpt/speech/gtts.py new file mode 100644 index 00000000..37497075 --- /dev/null +++ b/autogpt/speech/gtts.py @@ -0,0 +1,21 @@ +""" GTTS Voice. """ +import os +from playsound import playsound +import gtts + +from autogpt.speech.base import VoiceBase + + +class GTTSVoice(VoiceBase): + """GTTS Voice.""" + + def _setup(self) -> None: + pass + + def _speech(self, text: str, _: int = 0) -> bool: + """Play the given text.""" + tts = gtts.gTTS(text) + tts.save("speech.mp3") + playsound("speech.mp3", True) + os.remove("speech.mp3") + return True diff --git a/autogpt/speech/macos_tts.py b/autogpt/speech/macos_tts.py new file mode 100644 index 00000000..4c072ce2 --- /dev/null +++ b/autogpt/speech/macos_tts.py @@ -0,0 +1,21 @@ +""" MacOS TTS Voice. """ +import os + +from autogpt.speech.base import VoiceBase + + +class MacOSTTS(VoiceBase): + """MacOS TTS Voice.""" + + def _setup(self) -> None: + pass + + def _speech(self, text: str, voice_index: int = 0) -> bool: + """Play the given text.""" + if voice_index == 0: + os.system(f'say "{text}"') + elif voice_index == 1: + os.system(f'say -v "Ava (Premium)" "{text}"') + else: + os.system(f'say -v Samantha "{text}"') + return True diff --git a/autogpt/speech/say.py b/autogpt/speech/say.py new file mode 100644 index 00000000..78b75b21 --- /dev/null +++ b/autogpt/speech/say.py @@ -0,0 +1,42 @@ +""" Text to speech module """ +from autogpt.config import Config + +import threading +from threading import Semaphore +from autogpt.speech.brian import BrianSpeech +from autogpt.speech.macos_tts import MacOSTTS +from autogpt.speech.gtts import GTTSVoice +from autogpt.speech.eleven_labs import ElevenLabsSpeech + + +CFG = Config() +DEFAULT_VOICE_ENGINE = GTTSVoice() +VOICE_ENGINE = None +if CFG.elevenlabs_api_key: + VOICE_ENGINE = ElevenLabsSpeech() +elif CFG.use_mac_os_tts == "True": + VOICE_ENGINE = MacOSTTS() +elif CFG.use_brian_tts == "True": + VOICE_ENGINE = BrianSpeech() +else: + VOICE_ENGINE = GTTSVoice() + + +QUEUE_SEMAPHORE = Semaphore( + 1 +) # The amount of sounds to queue before blocking the main thread + + +def say_text(text: str, voice_index: int = 0) -> None: + """Speak the given text using the given voice index""" + + def speak() -> None: + success = VOICE_ENGINE.say(text, voice_index) + if not success: + DEFAULT_VOICE_ENGINE.say(text) + + QUEUE_SEMAPHORE.release() + + QUEUE_SEMAPHORE.acquire(True) + thread = threading.Thread(target=speak) + thread.start() diff --git a/autogpt/spinner.py b/autogpt/spinner.py index 65679d56..56b4f20a 100644 --- a/autogpt/spinner.py +++ b/autogpt/spinner.py @@ -1,3 +1,4 @@ +"""A simple spinner module""" import itertools import sys import threading @@ -7,15 +8,20 @@ import time class Spinner: """A simple spinner class""" - def __init__(self, message="Loading...", delay=0.1): - """Initialize the spinner class""" + def __init__(self, message: str = "Loading...", delay: float = 0.1) -> None: + """Initialize the spinner class + + Args: + message (str): The message to display. + delay (float): The delay between each spinner update. + """ self.spinner = itertools.cycle(["-", "/", "|", "\\"]) self.delay = delay self.message = message self.running = False self.spinner_thread = None - def spin(self): + def spin(self) -> None: """Spin the spinner""" while self.running: sys.stdout.write(f"{next(self.spinner)} {self.message}\r") @@ -23,14 +29,20 @@ class Spinner: time.sleep(self.delay) sys.stdout.write(f"\r{' ' * (len(self.message) + 2)}\r") - def __enter__(self): + def __enter__(self) -> None: """Start the spinner""" self.running = True self.spinner_thread = threading.Thread(target=self.spin) self.spinner_thread.start() - def __exit__(self, exc_type, exc_value, exc_traceback): - """Stop the spinner""" + def __exit__(self, exc_type, exc_value, exc_traceback) -> None: + """Stop the spinner + + Args: + exc_type (Exception): The exception type. + exc_value (Exception): The exception value. + exc_traceback (Exception): The exception traceback. + """ self.running = False if self.spinner_thread is not None: self.spinner_thread.join() diff --git a/autogpt/summary.py b/autogpt/summary.py deleted file mode 100644 index 38f0aadc..00000000 --- a/autogpt/summary.py +++ /dev/null @@ -1,69 +0,0 @@ -from autogpt.llm_utils import create_chat_completion - - -def summarize_text(driver, text, question): - if not text: - return "Error: No text to summarize" - - text_length = len(text) - print(f"Text length: {text_length} characters") - - summaries = [] - chunks = list(split_text(text)) - - scroll_ratio = 1 / len(chunks) - for i, chunk in enumerate(chunks): - scroll_to_percentage(driver, scroll_ratio * i) - print(f"Summarizing chunk {i + 1} / {len(chunks)}") - messages = [create_message(chunk, question)] - - summary = create_chat_completion( - model="gpt-3.5-turbo", - messages=messages, - max_tokens=300, - ) - summaries.append(summary) - - print(f"Summarized {len(chunks)} chunks.") - - combined_summary = "\n".join(summaries) - messages = [create_message(combined_summary, question)] - - return create_chat_completion( - model="gpt-3.5-turbo", - messages=messages, - max_tokens=300, - ) - - -def split_text(text, max_length=8192): - paragraphs = text.split("\n") - current_length = 0 - current_chunk = [] - - for paragraph in paragraphs: - if current_length + len(paragraph) + 1 <= max_length: - current_chunk.append(paragraph) - current_length += len(paragraph) + 1 - else: - yield "\n".join(current_chunk) - current_chunk = [paragraph] - current_length = len(paragraph) + 1 - - if current_chunk: - yield "\n".join(current_chunk) - - -def create_message(chunk, question): - return { - "role": "user", - "content": f'"""{chunk}""" Using the above text, please answer the following' - f' question: "{question}" -- if the question cannot be answered using the text,' - " please summarize the text.", - } - - -def scroll_to_percentage(driver, ratio): - if ratio < 0 or ratio > 1: - raise ValueError("Percentage should be between 0 and 1") - driver.execute_script(f"window.scrollTo(0, document.body.scrollHeight * {ratio});") diff --git a/autogpt/token_counter.py b/autogpt/token_counter.py index 875e8d42..c1239722 100644 --- a/autogpt/token_counter.py +++ b/autogpt/token_counter.py @@ -1,8 +1,9 @@ +"""Functions for counting the number of tokens in a message or string.""" from typing import Dict, List import tiktoken -from autogpt.logger import logger +from autogpt.logs import logger def count_message_tokens( @@ -12,13 +13,13 @@ def count_message_tokens( Returns the number of tokens used by a list of messages. Args: - messages (list): A list of messages, each of which is a dictionary - containing the role and content of the message. - model (str): The name of the model to use for tokenization. - Defaults to "gpt-3.5-turbo-0301". + messages (list): A list of messages, each of which is a dictionary + containing the role and content of the message. + model (str): The name of the model to use for tokenization. + Defaults to "gpt-3.5-turbo-0301". Returns: - int: The number of tokens used by the list of messages. + int: The number of tokens used by the list of messages. """ try: encoding = tiktoken.encoding_for_model(model) @@ -62,11 +63,11 @@ def count_string_tokens(string: str, model_name: str) -> int: Returns the number of tokens in a text string. Args: - string (str): The text string. - model_name (str): The name of the encoding to use. (e.g., "gpt-3.5-turbo") + string (str): The text string. + model_name (str): The name of the encoding to use. (e.g., "gpt-3.5-turbo") Returns: - int: The number of tokens in the text string. + int: The number of tokens in the text string. """ encoding = tiktoken.encoding_for_model(model_name) return len(encoding.encode(string)) diff --git a/autogpt/web.py b/autogpt/web.py deleted file mode 100644 index 355f7fd3..00000000 --- a/autogpt/web.py +++ /dev/null @@ -1,85 +0,0 @@ -from selenium import webdriver -import autogpt.summary as summary -from bs4 import BeautifulSoup -from selenium.webdriver.common.by import By -from selenium.webdriver.support.wait import WebDriverWait -from selenium.webdriver.support import expected_conditions as EC -from webdriver_manager.chrome import ChromeDriverManager -from selenium.webdriver.chrome.options import Options -import logging -from pathlib import Path -from autogpt.config import Config - -file_dir = Path(__file__).parent -cfg = Config() - - -def browse_website(url, question): - driver, text = scrape_text_with_selenium(url) - add_header(driver) - summary_text = summary.summarize_text(driver, text, question) - links = scrape_links_with_selenium(driver) - - # Limit links to 5 - if len(links) > 5: - links = links[:5] - close_browser(driver) - return f"Answer gathered from website: {summary_text} \n \n Links: {links}", driver - - -def scrape_text_with_selenium(url): - logging.getLogger("selenium").setLevel(logging.CRITICAL) - - options = Options() - options.add_argument( - "user-agent=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/112.0.5615.49 Safari/537.36" - ) - driver = webdriver.Chrome( - executable_path=ChromeDriverManager().install(), options=options - ) - driver.get(url) - - WebDriverWait(driver, 10).until( - EC.presence_of_element_located((By.TAG_NAME, "body")) - ) - - # Get the HTML content directly from the browser's DOM - page_source = driver.execute_script("return document.body.outerHTML;") - soup = BeautifulSoup(page_source, "html.parser") - - for script in soup(["script", "style"]): - script.extract() - - text = soup.get_text() - lines = (line.strip() for line in text.splitlines()) - chunks = (phrase.strip() for line in lines for phrase in line.split(" ")) - text = "\n".join(chunk for chunk in chunks if chunk) - return driver, text - - -def scrape_links_with_selenium(driver): - page_source = driver.page_source - soup = BeautifulSoup(page_source, "html.parser") - - for script in soup(["script", "style"]): - script.extract() - - hyperlinks = extract_hyperlinks(soup) - - return format_hyperlinks(hyperlinks) - - -def close_browser(driver): - driver.quit() - - -def extract_hyperlinks(soup): - return [(link.text, link["href"]) for link in soup.find_all("a", href=True)] - - -def format_hyperlinks(hyperlinks): - return [f"{link_text} ({link_url})" for link_text, link_url in hyperlinks] - - -def add_header(driver): - driver.execute_script(open(f"{file_dir}/js/overlay.js", "r").read()) diff --git a/scripts/main.py b/scripts/main.py deleted file mode 100644 index b6871d1c..00000000 --- a/scripts/main.py +++ /dev/null @@ -1,11 +0,0 @@ -from colorama import Style, init - -# Initialize colorama -init(autoreset=True) - -# Use the bold ANSI style -print( - f"""{Style.BRIGHT}Please run: -python -m autogpt -""" -) diff --git a/tests/test_json_parser.py b/tests/test_json_parser.py index 7e3d4f51..2862034b 100644 --- a/tests/test_json_parser.py +++ b/tests/test_json_parser.py @@ -1,7 +1,7 @@ import unittest import tests.context -from autogpt.json_parser import fix_and_parse_json +from autogpt.json_fixes.parsing import fix_and_parse_json class TestParseJson(unittest.TestCase): diff --git a/tests/unit/test_browse_scrape_text.py b/tests/unit/test_browse_scrape_text.py index be075ad7..98f5f558 100644 --- a/tests/unit/test_browse_scrape_text.py +++ b/tests/unit/test_browse_scrape_text.py @@ -2,7 +2,7 @@ import requests -from autogpt.browse import scrape_text +from autogpt.commands.web_requests import scrape_text """ Code Analysis From bdefa24ac6adcc810ff144bd62b08a0d0e6b9c40 Mon Sep 17 00:00:00 2001 From: Drikus Roor Date: Sat, 15 Apr 2023 14:50:54 +0200 Subject: [PATCH 32/78] test: Write unit tests for token_counter --- autogpt/token_counter.py | 2 +- tests/test_token_counter.py | 61 +++++++++++++++++++++++++++++++++++++ 2 files changed, 62 insertions(+), 1 deletion(-) create mode 100644 tests/test_token_counter.py diff --git a/autogpt/token_counter.py b/autogpt/token_counter.py index c1239722..a85a54be 100644 --- a/autogpt/token_counter.py +++ b/autogpt/token_counter.py @@ -27,7 +27,7 @@ def count_message_tokens( logger.warn("Warning: model not found. Using cl100k_base encoding.") encoding = tiktoken.get_encoding("cl100k_base") if model == "gpt-3.5-turbo": - # !Node: gpt-3.5-turbo may change over time. + # !Note: gpt-3.5-turbo may change over time. # Returning num tokens assuming gpt-3.5-turbo-0301.") return count_message_tokens(messages, model="gpt-3.5-turbo-0301") elif model == "gpt-4": diff --git a/tests/test_token_counter.py b/tests/test_token_counter.py new file mode 100644 index 00000000..d13f2ae0 --- /dev/null +++ b/tests/test_token_counter.py @@ -0,0 +1,61 @@ +import unittest +import tests.context + +from scripts.token_counter import count_message_tokens, count_string_tokens + +class TestTokenCounter(unittest.TestCase): + + def test_count_message_tokens(self): + messages = [ + {"role": "user", "content": "Hello"}, + {"role": "assistant", "content": "Hi there!"} + ] + self.assertEqual(count_message_tokens(messages), 17) + + def test_count_message_tokens_with_name(self): + messages = [ + {"role": "user", "content": "Hello", "name": "John"}, + {"role": "assistant", "content": "Hi there!"} + ] + self.assertEqual(count_message_tokens(messages), 17) + + def test_count_message_tokens_empty_input(self): + self.assertEqual(count_message_tokens([]), 3) + + def test_count_message_tokens_invalid_model(self): + messages = [ + {"role": "user", "content": "Hello"}, + {"role": "assistant", "content": "Hi there!"} + ] + with self.assertRaises(KeyError): + count_message_tokens(messages, model="invalid_model") + + def test_count_message_tokens_gpt_4(self): + messages = [ + {"role": "user", "content": "Hello"}, + {"role": "assistant", "content": "Hi there!"} + ] + self.assertEqual(count_message_tokens(messages, model="gpt-4-0314"), 15) + + def test_count_string_tokens(self): + string = "Hello, world!" + self.assertEqual(count_string_tokens(string, model_name="gpt-3.5-turbo-0301"), 4) + + def test_count_string_tokens_empty_input(self): + self.assertEqual(count_string_tokens("", model_name="gpt-3.5-turbo-0301"), 0) + + def test_count_message_tokens_invalid_model(self): + messages = [ + {"role": "user", "content": "Hello"}, + {"role": "assistant", "content": "Hi there!"} + ] + with self.assertRaises(NotImplementedError): + count_message_tokens(messages, model="invalid_model") + + def test_count_string_tokens_gpt_4(self): + string = "Hello, world!" + self.assertEqual(count_string_tokens(string, model_name="gpt-4-0314"), 4) + + +if __name__ == '__main__': + unittest.main() From d52381eead2f4ae8d5db3ca2e747a6c5e3dc1cea Mon Sep 17 00:00:00 2001 From: Drikus Roor Date: Sat, 15 Apr 2023 15:20:19 +0200 Subject: [PATCH 33/78] fix: Fix imports --- tests/test_token_counter.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tests/test_token_counter.py b/tests/test_token_counter.py index d13f2ae0..42670e60 100644 --- a/tests/test_token_counter.py +++ b/tests/test_token_counter.py @@ -1,7 +1,7 @@ import unittest import tests.context +from autogpt.token_counter import count_message_tokens, count_string_tokens -from scripts.token_counter import count_message_tokens, count_string_tokens class TestTokenCounter(unittest.TestCase): From 395d9d048128d3008b36d79a9952c8a29bc0aad0 Mon Sep 17 00:00:00 2001 From: chyezh Date: Tue, 11 Apr 2023 19:36:41 +0800 Subject: [PATCH 34/78] enable milvus as memory backend --- .env.template | 7 +++ README.md | 38 ++++++++++++---- autogpt/config/config.py | 4 ++ autogpt/memory/__init__.py | 14 +++++- requirements.txt | 1 + scripts/memory/milvus.py | 90 ++++++++++++++++++++++++++++++++++++++ 6 files changed, 145 insertions(+), 9 deletions(-) create mode 100644 scripts/memory/milvus.py diff --git a/.env.template b/.env.template index 22bf8d74..b8140dd8 100644 --- a/.env.template +++ b/.env.template @@ -77,6 +77,13 @@ REDIS_PASSWORD= WIPE_REDIS_ON_START=False MEMORY_INDEX=auto-gpt +### MILVUS +# MILVUS_ADDR - Milvus remote address (e.g. localhost:19530) +# MILVUS_COLLECTION - Milvus collection, +# change it if you want to start a new memory and retain the old memory. +MILVUS_ADDR=your-milvus-cluster-host-port +MILVUS_COLLECTION=autogpt + ################################################################################ ### IMAGE GENERATION PROVIDER ################################################################################ diff --git a/README.md b/README.md index ba421774..00bb0ea3 100644 --- a/README.md +++ b/README.md @@ -35,22 +35,27 @@ Your support is greatly appreciated ## Table of Contents - [Auto-GPT: An Autonomous GPT-4 Experiment](#auto-gpt-an-autonomous-gpt-4-experiment) - - [Demo (30/03/2023):](#demo-30032023) + - [๐Ÿ”ด ๐Ÿ”ด ๐Ÿ”ด Urgent: USE `stable` not `master` ๐Ÿ”ด ๐Ÿ”ด ๐Ÿ”ด](#----urgent-use-stable-not-master----) + - [Demo (30/03/2023):](#demo-30032023) - [Table of Contents](#table-of-contents) - [๐Ÿš€ Features](#-features) - [๐Ÿ“‹ Requirements](#-requirements) - [๐Ÿ’พ Installation](#-installation) - [๐Ÿ”ง Usage](#-usage) - [Logs](#logs) + - [Docker](#docker) + - [Command Line Arguments](#command-line-arguments) - [๐Ÿ—ฃ๏ธ Speech Mode](#๏ธ-speech-mode) - [๐Ÿ” Google API Keys Configuration](#-google-api-keys-configuration) - [Setting up environment variables](#setting-up-environment-variables) - - [Redis Setup](#redis-setup) - - [๐ŸŒฒ Pinecone API Key Setup](#-pinecone-api-key-setup) + - [Memory Backend Setup](#memory-backend-setup) + - [Redis Setup](#redis-setup) + - [๐ŸŒฒ Pinecone API Key Setup](#-pinecone-api-key-setup) + - [Milvus Setup](#milvus-setup) - [Setting up environment variables](#setting-up-environment-variables-1) - [Setting Your Cache Type](#setting-your-cache-type) - [View Memory Usage](#view-memory-usage) - - [๐Ÿง  Memory pre-seeding](#memory-pre-seeding) + - [๐Ÿง  Memory pre-seeding](#-memory-pre-seeding) - [๐Ÿ’€ Continuous Mode โš ๏ธ](#-continuous-mode-๏ธ) - [GPT3.5 ONLY Mode](#gpt35-only-mode) - [๐Ÿ–ผ Image Generation](#-image-generation) @@ -75,10 +80,11 @@ Your support is greatly appreciated - [Python 3.8 or later](https://www.tutorialspoint.com/how-to-install-python-in-windows) - [OpenAI API key](https://platform.openai.com/account/api-keys) - Optional: -- [PINECONE API key](https://www.pinecone.io/) (If you want Pinecone backed memory) +- Memory backend + - [PINECONE API key](https://www.pinecone.io/) (If you want Pinecone backed memory) + - [Milvus](https://milvus.io/) (If you want Milvus as memory backend) - ElevenLabs Key (If you want the AI to speak) ## ๐Ÿ’พ Installation @@ -209,7 +215,11 @@ export CUSTOM_SEARCH_ENGINE_ID="YOUR_CUSTOM_SEARCH_ENGINE_ID" ``` -## Redis Setup +## Memory Backend Setup + +Setup any one backend to persist memory. + +### Redis Setup Install docker desktop. @@ -246,7 +256,7 @@ You can specify the memory index for redis using the following: MEMORY_INDEX=whatever ``` -## ๐ŸŒฒ Pinecone API Key Setup +### ๐ŸŒฒ Pinecone API Key Setup Pinecone enables the storage of vast amounts of vector-based memory, allowing for only relevant memories to be loaded for the agent at any given time. @@ -254,6 +264,18 @@ Pinecone enables the storage of vast amounts of vector-based memory, allowing fo 2. Choose the `Starter` plan to avoid being charged. 3. Find your API key and region under the default project in the left sidebar. +### Milvus Setup + +[Milvus](https://milvus.io/) is a open-source, high scalable vector database to storage huge amount of vector-based memory and provide fast relevant search. + +- setup milvus database, keep your pymilvus version and milvus version same to avoid compatible issues. + - setup by open source [Install Milvus](https://milvus.io/docs/install_standalone-operator.md) + - or setup by [Zilliz Cloud](https://zilliz.com/cloud) +- set `MILVUS_ADDR` in `.env` to your milvus address `host:ip`. +- set `MEMORY_BACKEND` in `.env` to `milvus` to enable milvus as backend. +- optional + - set `MILVUS_COLLECTION` in `.env` to change milvus collection name as you want, `autogpt` is the default name. + ### Setting up environment variables In the `.env` file set: diff --git a/autogpt/config/config.py b/autogpt/config/config.py index 46764b9c..667c8178 100644 --- a/autogpt/config/config.py +++ b/autogpt/config/config.py @@ -62,6 +62,10 @@ class Config(metaclass=Singleton): self.pinecone_api_key = os.getenv("PINECONE_API_KEY") self.pinecone_region = os.getenv("PINECONE_ENV") + # milvus configuration, e.g., localhost:19530. + self.milvus_addr = os.getenv("MILVUS_ADDR", "localhost:19530") + self.milvus_collection = os.getenv("MILVUS_COLLECTION", "autogpt") + self.image_provider = os.getenv("IMAGE_PROVIDER") self.huggingface_api_token = os.getenv("HUGGINGFACE_API_TOKEN") diff --git a/autogpt/memory/__init__.py b/autogpt/memory/__init__.py index 42ba5a65..670efda1 100644 --- a/autogpt/memory/__init__.py +++ b/autogpt/memory/__init__.py @@ -21,6 +21,12 @@ except ImportError: print("Pinecone not installed. Skipping import.") PineconeMemory = None +try: + from memory.milvus import MilvusMemory +except ImportError: + print("pymilvus not installed. Skipping import.") + MilvusMemory = None + def get_memory(cfg, init=False): memory = None @@ -44,6 +50,12 @@ def get_memory(cfg, init=False): memory = RedisMemory(cfg) elif cfg.memory_backend == "no_memory": memory = NoMemory(cfg) + elif cfg.memory_backend == "milvus": + if not MilvusMemory: + print("Error: Milvus sdk is not installed." + "Please install pymilvus to use Milvus as memory backend.") + else: + memory = MilvusMemory(cfg) if memory is None: memory = LocalCache(cfg) @@ -56,4 +68,4 @@ def get_supported_memory_backends(): return supported_memory -__all__ = ["get_memory", "LocalCache", "RedisMemory", "PineconeMemory", "NoMemory"] +__all__ = ["get_memory", "LocalCache", "RedisMemory", "PineconeMemory", "NoMemory", "MilvusMemory"] diff --git a/requirements.txt b/requirements.txt index 44cd600f..2fec1b16 100644 --- a/requirements.txt +++ b/requirements.txt @@ -12,6 +12,7 @@ docker duckduckgo-search google-api-python-client #(https://developers.google.com/custom-search/v1/overview) pinecone-client==2.2.1 +pymilvus==2.2.4 redis orjson Pillow diff --git a/scripts/memory/milvus.py b/scripts/memory/milvus.py new file mode 100644 index 00000000..c6d31750 --- /dev/null +++ b/scripts/memory/milvus.py @@ -0,0 +1,90 @@ +from pymilvus import ( + connections, + FieldSchema, + CollectionSchema, + DataType, + Collection, +) + +from memory.base import MemoryProviderSingleton, get_ada_embedding + + +class MilvusMemory(MemoryProviderSingleton): + def __init__(self, cfg): + """ Construct a milvus memory storage connection. + + Args: + cfg (Config): Auto-GPT global config. + """ + # connect to milvus server. + connections.connect(address=cfg.milvus_addr) + fields = [ + FieldSchema(name="pk", dtype=DataType.INT64, + is_primary=True, auto_id=True), + FieldSchema(name="embeddings", + dtype=DataType.FLOAT_VECTOR, dim=1536), + FieldSchema(name="raw_text", dtype=DataType.VARCHAR, + max_length=65535) + ] + + # create collection if not exist and load it. + schema = CollectionSchema(fields, "auto-gpt memory storage") + self.collection = Collection(cfg.milvus_collection, schema) + # create index if not exist. + if not self.collection.has_index(index_name="embeddings"): + self.collection.release() + self.collection.create_index("embeddings", { + "index_type": "IVF_FLAT", + "metric_type": "IP", + "params": {"nlist": 128}, + }, index_name="embeddings") + self.collection.load() + + def add(self, data): + """ Add a embedding of data into memory. + + Args: + data (str): The raw text to construct embedding index. + + Returns: + str: log. + """ + embedding = get_ada_embedding(data) + result = self.collection.insert([[embedding], [data]]) + _text = f"Inserting data into memory at primary key: {result.primary_keys[0]}:\n data: {data}" + return _text + + def get(self, data): + """ Return the most relevant data in memory. + Args: + data: The data to compare to. + """ + return self.get_relevant(data, 1) + + def clear(self): + """ Drop the index in memory. + """ + self.collection.drop() + return "Obliviated" + + def get_relevant(self, data, num_relevant=5): + """ Return the top-k relevant data in memory. + Args: + data: The data to compare to. + num_relevant (int, optional): The max number of relevant data. Defaults to 5. + """ + # search the embedding and return the most relevant text. + embedding = get_ada_embedding(data) + search_params = { + "metrics_type": "IP", + "params": {"nprobe": 8}, + } + result = self.collection.search( + [embedding], "embeddings", search_params, num_relevant, output_fields=["raw_text"]) + return [item.entity.value_of_field("raw_text") for item in result[0]] + + def get_stats(self): + """ + Returns: The stats of the milvus cache. + """ + return f"Entities num: {self.collection.num_entities}" From e90e618c5ee9b37ebbc38bd4c75805d3cbceef17 Mon Sep 17 00:00:00 2001 From: Eesa Hamza Date: Sat, 15 Apr 2023 16:28:34 +0300 Subject: [PATCH 35/78] Added agnostic browser support --- .env.template | 3 +++ autogpt/__main__.py | 4 +++- autogpt/args.py | 9 +++++++++ autogpt/commands/web_selenium.py | 28 +++++++++++++++++++++------- autogpt/config/config.py | 1 + 5 files changed, 37 insertions(+), 8 deletions(-) diff --git a/.env.template b/.env.template index 22bf8d74..4a334bea 100644 --- a/.env.template +++ b/.env.template @@ -11,6 +11,9 @@ BROWSE_SUMMARY_MAX_TOKEN=300 # USER_AGENT="Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.97 Safari/537.36" # AI_SETTINGS_FILE - Specifies which AI Settings file to use (defaults to ai_settings.yaml) AI_SETTINGS_FILE=ai_settings.yaml +# USE_WEB_BROWSER - Sets the web-browser drivers to use with selenium (defaults to chrome). +# Note: set this to either 'chrome', 'firefox', or 'safari' depending on your current browser +# USE_WEB_BROWSER=chrome ################################################################################ ### LLM PROVIDER diff --git a/autogpt/__main__.py b/autogpt/__main__.py index f90f1532..5105df55 100644 --- a/autogpt/__main__.py +++ b/autogpt/__main__.py @@ -1,5 +1,6 @@ """Main script for the autogpt package.""" import logging +from colorama import Fore from autogpt.agent.agent import Agent from autogpt.args import parse_arguments @@ -33,7 +34,8 @@ def main() -> None: # Initialize memory and make sure it is empty. # this is particularly important for indexing and referencing pinecone memory memory = get_memory(cfg, init=True) - print(f"Using memory of type: {memory.__class__.__name__}") + logger.typewriter_log(f"Using memory of type:", Fore.GREEN, f"{memory.__class__.__name__}") + logger.typewriter_log(f"Using Browser:", Fore.GREEN, cfg.selenium_web_browser) agent = Agent( ai_name=ai_name, memory=memory, diff --git a/autogpt/args.py b/autogpt/args.py index 6c907a1f..0bc3e680 100644 --- a/autogpt/args.py +++ b/autogpt/args.py @@ -50,6 +50,12 @@ def parse_arguments() -> None: action="store_true", help="Skips the re-prompting messages at the beginning of the script", ) + parser.add_argument( + "--use-browser", + "-b", + dest="browser_name", + help="Specifies which web-browser to use when using selenium to scrape the web." + ) parser.add_argument( "--ai-settings", "-C", @@ -126,3 +132,6 @@ def parse_arguments() -> None: logger.typewriter_log("Using AI Settings File:", Fore.GREEN, file) CFG.ai_settings_file = file CFG.skip_reprompt = True + + if args.browser_name: + CFG.selenium_web_browser = args.browser_name diff --git a/autogpt/commands/web_selenium.py b/autogpt/commands/web_selenium.py index 4d5703aa..379d8cbe 100644 --- a/autogpt/commands/web_selenium.py +++ b/autogpt/commands/web_selenium.py @@ -7,7 +7,10 @@ from selenium.webdriver.common.by import By from selenium.webdriver.support.wait import WebDriverWait from selenium.webdriver.support import expected_conditions as EC from webdriver_manager.chrome import ChromeDriverManager -from selenium.webdriver.chrome.options import Options +from webdriver_manager.firefox import GeckoDriverManager +from selenium.webdriver.chrome.options import Options as ChromeOptions +from selenium.webdriver.firefox.options import Options as FirefoxOptions +from selenium.webdriver.safari.options import Options as SafariOptions import logging from pathlib import Path from autogpt.config import Config @@ -49,14 +52,25 @@ def scrape_text_with_selenium(url: str) -> tuple[WebDriver, str]: """ logging.getLogger("selenium").setLevel(logging.CRITICAL) - options = Options() + options_available = {'chrome': ChromeOptions, 'safari': SafariOptions, 'firefox': FirefoxOptions} + + options = options_available[CFG.selenium_web_browser]() options.add_argument( - "user-agent=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36" - " (KHTML, like Gecko) Chrome/112.0.5615.49 Safari/537.36" - ) - driver = webdriver.Chrome( - executable_path=ChromeDriverManager().install(), options=options + "user-agent=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/112.0.5615.49 Safari/537.36" ) + + if CFG.selenium_web_browser == "firefox": + driver = webdriver.Firefox( + executable_path=GeckoDriverManager().install(), options=options + ) + elif CFG.selenium_web_browser == "safari": + # Requires a bit more setup on the users end + # See https://developer.apple.com/documentation/webkit/testing_with_webdriver_in_safari + driver = webdriver.Safari(options=options) + else: + driver = webdriver.Chrome( + executable_path=ChromeDriverManager().install(), options=options + ) driver.get(url) WebDriverWait(driver, 10).until( diff --git a/autogpt/config/config.py b/autogpt/config/config.py index 46764b9c..87e53304 100644 --- a/autogpt/config/config.py +++ b/autogpt/config/config.py @@ -25,6 +25,7 @@ class Config(metaclass=Singleton): self.speak_mode = False self.skip_reprompt = False + self.selenium_web_browser = os.getenv("USE_WEB_BROWSER", "chrome") self.ai_settings_file = os.getenv("AI_SETTINGS_FILE", "ai_settings.yaml") self.fast_llm_model = os.getenv("FAST_LLM_MODEL", "gpt-3.5-turbo") self.smart_llm_model = os.getenv("SMART_LLM_MODEL", "gpt-4") From 55facfd8db41342a9879321204480ecd4b6cf950 Mon Sep 17 00:00:00 2001 From: Bufo Date: Sat, 15 Apr 2023 15:59:14 +0200 Subject: [PATCH 36/78] remove sourcery from docker build --- Dockerfile | 6 +++--- requirements-docker.txt | 25 +++++++++++++++++++++++++ 2 files changed, 28 insertions(+), 3 deletions(-) create mode 100644 requirements-docker.txt diff --git a/Dockerfile b/Dockerfile index 3ae1ac12..d62751fa 100644 --- a/Dockerfile +++ b/Dockerfile @@ -13,11 +13,11 @@ RUN chown appuser:appuser /home/appuser USER appuser # Copy the requirements.txt file and install the requirements -COPY --chown=appuser:appuser requirements.txt . -RUN pip install --no-cache-dir --user -r requirements.txt +COPY --chown=appuser:appuser requirements-docker.txt . +RUN pip install --no-cache-dir --user -r requirements-docker.txt # Copy the application files -COPY --chown=appuser:appuser autogpt/ . +COPY --chown=appuser:appuser autogpt/ ./autogpt # Set the entrypoint ENTRYPOINT ["python", "-m", "autogpt"] diff --git a/requirements-docker.txt b/requirements-docker.txt new file mode 100644 index 00000000..fecbd0a6 --- /dev/null +++ b/requirements-docker.txt @@ -0,0 +1,25 @@ +beautifulsoup4 +colorama==0.4.6 +openai==0.27.2 +playsound==1.2.2 +python-dotenv==1.0.0 +pyyaml==6.0 +readability-lxml==0.8.1 +requests +tiktoken==0.3.3 +gTTS==2.3.1 +docker +duckduckgo-search +google-api-python-client #(https://developers.google.com/custom-search/v1/overview) +pinecone-client==2.2.1 +redis +orjson +Pillow +selenium +webdriver-manager +coverage +flake8 +numpy +pre-commit +black +isort From afd2c5e2c6c33685e2e1ba815cf2ee46e278301f Mon Sep 17 00:00:00 2001 From: youkaichao Date: Sat, 15 Apr 2023 22:04:05 +0800 Subject: [PATCH 37/78] update type annotation --- autogpt/agent/agent_manager.py | 2 +- autogpt/commands/web_requests.py | 2 +- autogpt/commands/web_selenium.py | 23 ++++++++++++----------- 3 files changed, 14 insertions(+), 13 deletions(-) diff --git a/autogpt/agent/agent_manager.py b/autogpt/agent/agent_manager.py index a22adff3..3467f8bf 100644 --- a/autogpt/agent/agent_manager.py +++ b/autogpt/agent/agent_manager.py @@ -14,7 +14,7 @@ class AgentManager(metaclass=Singleton): # Create new GPT agent # TODO: Centralise use of create_chat_completion() to globally enforce token limit - def create_agent(self, task: str, prompt: str, model: str) -> tuple[int, str]: + def create_agent(self, task: str, prompt: str, model: str) -> Tuple[int, str]: """Create a new agent and return its key Args: diff --git a/autogpt/commands/web_requests.py b/autogpt/commands/web_requests.py index 59c3e522..97b23fe4 100644 --- a/autogpt/commands/web_requests.py +++ b/autogpt/commands/web_requests.py @@ -72,7 +72,7 @@ def get_response( timeout (int): The timeout for the HTTP request Returns: - tuple[None, str] | tuple[Response, None]: The response and error message + Tuple[None, str] | Tuple[Response, None]: The response and error message Raises: ValueError: If the URL is invalid diff --git a/autogpt/commands/web_selenium.py b/autogpt/commands/web_selenium.py index 4d5703aa..727695ef 100644 --- a/autogpt/commands/web_selenium.py +++ b/autogpt/commands/web_selenium.py @@ -11,12 +11,13 @@ from selenium.webdriver.chrome.options import Options import logging from pathlib import Path from autogpt.config import Config +from typing import List, Tuple, Union FILE_DIR = Path(__file__).parent.parent CFG = Config() -def browse_website(url: str, question: str) -> tuple[str, WebDriver]: +def browse_website(url: str, question: str) -> Tuple[str, WebDriver]: """Browse a website and return the answer and links to the user Args: @@ -24,7 +25,7 @@ def browse_website(url: str, question: str) -> tuple[str, WebDriver]: question (str): The question asked by the user Returns: - tuple[str, WebDriver]: The answer and links to the user and the webdriver + Tuple[str, WebDriver]: The answer and links to the user and the webdriver """ driver, text = scrape_text_with_selenium(url) add_header(driver) @@ -38,14 +39,14 @@ def browse_website(url: str, question: str) -> tuple[str, WebDriver]: return f"Answer gathered from website: {summary_text} \n \n Links: {links}", driver -def scrape_text_with_selenium(url: str) -> tuple[WebDriver, str]: +def scrape_text_with_selenium(url: str) -> Tuple[WebDriver, str]: """Scrape text from a website using selenium Args: url (str): The url of the website to scrape Returns: - tuple[WebDriver, str]: The webdriver and the text scraped from the website + Tuple[WebDriver, str]: The webdriver and the text scraped from the website """ logging.getLogger("selenium").setLevel(logging.CRITICAL) @@ -77,14 +78,14 @@ def scrape_text_with_selenium(url: str) -> tuple[WebDriver, str]: return driver, text -def scrape_links_with_selenium(driver: WebDriver) -> list[str]: +def scrape_links_with_selenium(driver: WebDriver) -> List[str]: """Scrape links from a website using selenium Args: driver (WebDriver): The webdriver to use to scrape the links Returns: - list[str]: The links scraped from the website + List[str]: The links scraped from the website """ page_source = driver.page_source soup = BeautifulSoup(page_source, "html.parser") @@ -109,26 +110,26 @@ def close_browser(driver: WebDriver) -> None: driver.quit() -def extract_hyperlinks(soup: BeautifulSoup) -> list[tuple[str, str]]: +def extract_hyperlinks(soup: BeautifulSoup) -> List[Tuple[str, str]]: """Extract hyperlinks from a BeautifulSoup object Args: soup (BeautifulSoup): The BeautifulSoup object to extract the hyperlinks from Returns: - list[tuple[str, str]]: The hyperlinks extracted from the BeautifulSoup object + List[Tuple[str, str]]: The hyperlinks extracted from the BeautifulSoup object """ return [(link.text, link["href"]) for link in soup.find_all("a", href=True)] -def format_hyperlinks(hyperlinks: list[tuple[str, str]]) -> list[str]: +def format_hyperlinks(hyperlinks: List[Tuple[str, str]]) -> List[str]: """Format hyperlinks to be displayed to the user Args: - hyperlinks (list[tuple[str, str]]): The hyperlinks to format + hyperlinks (List[Tuple[str, str]]): The hyperlinks to format Returns: - list[str]: The formatted hyperlinks + List[str]: The formatted hyperlinks """ return [f"{link_text} ({link_url})" for link_text, link_url in hyperlinks] From a51b37f01c68fc00308ab01a47e6c93e34906fb3 Mon Sep 17 00:00:00 2001 From: youkaichao Date: Sat, 15 Apr 2023 22:10:22 +0800 Subject: [PATCH 38/78] fix dict type annotation --- autogpt/llm_utils.py | 2 +- autogpt/processing/text.py | 6 +++--- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/autogpt/llm_utils.py b/autogpt/llm_utils.py index f2418b65..260403e2 100644 --- a/autogpt/llm_utils.py +++ b/autogpt/llm_utils.py @@ -59,7 +59,7 @@ def create_chat_completion( """Create a chat completion using the OpenAI API Args: - messages (list[dict[str, str]]): The messages to send to the chat completion + messages (List[Dict[str, str]]): The messages to send to the chat completion model (str, optional): The model to use. Defaults to None. temperature (float, optional): The temperature to use. Defaults to 0.9. max_tokens (int, optional): The max tokens to use. Defaults to None. diff --git a/autogpt/processing/text.py b/autogpt/processing/text.py index 24e3bb85..d9e335f8 100644 --- a/autogpt/processing/text.py +++ b/autogpt/processing/text.py @@ -1,5 +1,5 @@ """Text processing functions""" -from typing import Generator, Optional +from typing import Generator, Optional, Dict from selenium.webdriver.remote.webdriver import WebDriver from autogpt.memory import get_memory from autogpt.config import Config @@ -114,7 +114,7 @@ def scroll_to_percentage(driver: WebDriver, ratio: float) -> None: driver.execute_script(f"window.scrollTo(0, document.body.scrollHeight * {ratio});") -def create_message(chunk: str, question: str) -> dict[str, str]: +def create_message(chunk: str, question: str) -> Dict[str, str]: """Create a message for the chat completion Args: @@ -122,7 +122,7 @@ def create_message(chunk: str, question: str) -> dict[str, str]: question (str): The question to answer Returns: - dict[str, str]: The message to send to the chat completion + Dict[str, str]: The message to send to the chat completion """ return { "role": "user", From 44bd3d67179f26ce065ca2e3f292018c230e4d30 Mon Sep 17 00:00:00 2001 From: Thibault Twahirwa Date: Sat, 15 Apr 2023 10:17:03 -0400 Subject: [PATCH 39/78] Fixed the import --- autogpt/json_fixes/auto_fix.py | 2 ++ 1 file changed, 2 insertions(+) diff --git a/autogpt/json_fixes/auto_fix.py b/autogpt/json_fixes/auto_fix.py index 60c089a2..9c632332 100644 --- a/autogpt/json_fixes/auto_fix.py +++ b/autogpt/json_fixes/auto_fix.py @@ -2,6 +2,8 @@ import json from autogpt.llm_utils import call_ai_function from autogpt.logs import logger +from autogpt.config import Config +cfg = Config() def fix_json(json_str: str, schema: str) -> str: From f9265e9b010378a33e4901ef2dd9fac4f345496a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20St=C3=BCbi?= Date: Sat, 15 Apr 2023 16:20:26 +0200 Subject: [PATCH 40/78] Some more file extensions to ignore --- .gitignore | 2 ++ 1 file changed, 2 insertions(+) diff --git a/.gitignore b/.gitignore index cf6e75df..3538e9fd 100644 --- a/.gitignore +++ b/.gitignore @@ -16,6 +16,8 @@ last_run_ai_settings.yaml .idea/* auto-gpt.json log.txt +*.log +*.mp3 # Coverage reports .coverage From a0de3868c6c77bf4d8605bbdbaf759037c04174e Mon Sep 17 00:00:00 2001 From: Summit Suen Date: Fri, 14 Apr 2023 15:33:43 +0800 Subject: [PATCH 41/78] Cleanup azure parameters in env.template and remove unused env in config.load_azure_config(). --- .env.template | 11 +---------- autogpt/config/config.py | 12 +++--------- 2 files changed, 4 insertions(+), 19 deletions(-) diff --git a/.env.template b/.env.template index 22bf8d74..53fe42ab 100644 --- a/.env.template +++ b/.env.template @@ -25,16 +25,7 @@ TEMPERATURE=1 USE_AZURE=False ### AZURE -# OPENAI_AZURE_API_BASE - OpenAI API base URL for Azure (Example: https://my-azure-openai-url.com) -# OPENAI_AZURE_API_VERSION - OpenAI API version for Azure (Example: v1) -# OPENAI_AZURE_DEPLOYMENT_ID - OpenAI deployment ID for Azure (Example: my-deployment-id) -# OPENAI_AZURE_CHAT_DEPLOYMENT_ID - OpenAI deployment ID for Azure Chat (Example: my-deployment-id-for-azure-chat) -# OPENAI_AZURE_EMBEDDINGS_DEPLOYMENT_ID - OpenAI deployment ID for Embedding (Example: my-deployment-id-for-azure-embeddigs) -OPENAI_AZURE_API_BASE=your-base-url-for-azure -OPENAI_AZURE_API_VERSION=api-version-for-azure -OPENAI_AZURE_DEPLOYMENT_ID=deployment-id-for-azure -OPENAI_AZURE_CHAT_DEPLOYMENT_ID=deployment-id-for-azure-chat -OPENAI_AZURE_EMBEDDINGS_DEPLOYMENT_ID=deployment-id-for-azure-embeddigs +# cleanup azure env as already moved to `azure.yaml.template` ################################################################################ ### LLM MODELS diff --git a/autogpt/config/config.py b/autogpt/config/config.py index 46764b9c..a51f4d20 100644 --- a/autogpt/config/config.py +++ b/autogpt/config/config.py @@ -127,15 +127,9 @@ class Config(metaclass=Singleton): config_params = yaml.load(file, Loader=yaml.FullLoader) except FileNotFoundError: config_params = {} - self.openai_api_type = os.getenv( - "OPENAI_API_TYPE", config_params.get("azure_api_type", "azure") - ) - self.openai_api_base = os.getenv( - "OPENAI_AZURE_API_BASE", config_params.get("azure_api_base", "") - ) - self.openai_api_version = os.getenv( - "OPENAI_AZURE_API_VERSION", config_params.get("azure_api_version", "") - ) + self.openai_api_type = config_params.get("azure_api_type") or "azure" + self.openai_api_base = config_params.get("azure_api_base") or "" + self.openai_api_version = config_params.get("azure_api_version") or "2023-03-15-preview" self.azure_model_to_deployment_id_map = config_params.get("azure_model_map", []) def set_continuous_mode(self, value: bool) -> None: From eb8b3e662278095f7c7b2ffebae872aadc4a6d5f Mon Sep 17 00:00:00 2001 From: Eddie Cohen Date: Thu, 13 Apr 2023 21:01:00 -0400 Subject: [PATCH 42/78] add gitpython --- requirements.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/requirements.txt b/requirements.txt index 2fec1b16..ab1920c0 100644 --- a/requirements.txt +++ b/requirements.txt @@ -25,3 +25,4 @@ pre-commit black sourcery isort +gitpython==3.1.31 From 4d8de551b54f7b83157757a4e4b30f59ef917319 Mon Sep 17 00:00:00 2001 From: Eddie Cohen Date: Thu, 13 Apr 2023 21:03:19 -0400 Subject: [PATCH 43/78] add prompt, env example, config --- .env.template | 10 ++++++++++ autogpt/config/config.py | 3 +++ autogpt/prompt.py | 1 + 3 files changed, 14 insertions(+) diff --git a/.env.template b/.env.template index b8140dd8..9013560f 100644 --- a/.env.template +++ b/.env.template @@ -99,6 +99,16 @@ IMAGE_PROVIDER=dalle # HUGGINGFACE_API_TOKEN - HuggingFace API token (Example: my-huggingface-api-token) HUGGINGFACE_API_TOKEN=your-huggingface-api-token +################################################################################ +### GIT Provider for repository actions +################################################################################ + +### GITHUB +# GITHUB_API_KEY - Github API key / PAT (Example: github_pat_123) +# GITHUB_USERNAME - Github username +GITHUB_API_KEY=github_pat_123 +GITHUB_USERNAME=your-github-username + ################################################################################ ### SEARCH PROVIDER ################################################################################ diff --git a/autogpt/config/config.py b/autogpt/config/config.py index 667c8178..1fe4a870 100644 --- a/autogpt/config/config.py +++ b/autogpt/config/config.py @@ -55,6 +55,9 @@ class Config(metaclass=Singleton): self.use_brian_tts = False self.use_brian_tts = os.getenv("USE_BRIAN_TTS") + + self.github_api_key = os.getenv("GITHUB_API_KEY") + self.github_username = os.getenv("GITHUB_USERNAME") self.google_api_key = os.getenv("GOOGLE_API_KEY") self.custom_search_engine_id = os.getenv("CUSTOM_SEARCH_ENGINE_ID") diff --git a/autogpt/prompt.py b/autogpt/prompt.py index 050c2560..20492978 100644 --- a/autogpt/prompt.py +++ b/autogpt/prompt.py @@ -55,6 +55,7 @@ def get_prompt() -> str: ), ("List GPT Agents", "list_agents", {}), ("Delete GPT Agent", "delete_agent", {"key": ""}), + ("Clone Repository", "clone_repository", {"repository_url": "", "clone_path": ""}), ("Write to file", "write_to_file", {"file": "", "text": ""}), ("Read file", "read_file", {"file": ""}), ("Append to file", "append_to_file", {"file": "", "text": ""}), From 0569d6652fbffa665de6e42403a48783fbede8ce Mon Sep 17 00:00:00 2001 From: Eddie Cohen Date: Thu, 13 Apr 2023 21:39:08 -0400 Subject: [PATCH 44/78] add command --- autogpt/commands.py | 311 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 311 insertions(+) create mode 100644 autogpt/commands.py diff --git a/autogpt/commands.py b/autogpt/commands.py new file mode 100644 index 00000000..1e8e9047 --- /dev/null +++ b/autogpt/commands.py @@ -0,0 +1,311 @@ +from autogpt import browse +import json +from autogpt.memory import get_memory +import datetime +import autogpt.agent_manager as agents +from autogpt import speak +from autogpt.config import Config +import autogpt.ai_functions as ai +from autogpt.file_operations import read_file, write_to_file, append_to_file, delete_file, search_files +from autogpt.execute_code import execute_python_file, execute_shell +from autogpt.json_parser import fix_and_parse_json +from autogpt.image_gen import generate_image +from duckduckgo_search import ddg +from googleapiclient.discovery import build +from googleapiclient.errors import HttpError + +cfg = Config() + + +def is_valid_int(value): + try: + int(value) + return True + except ValueError: + return False + + +def get_command(response): + """Parse the response and return the command name and arguments""" + try: + response_json = fix_and_parse_json(response) + + if "command" not in response_json: + return "Error:" , "Missing 'command' object in JSON" + + command = response_json["command"] + + if "name" not in command: + return "Error:", "Missing 'name' field in 'command' object" + + command_name = command["name"] + + # Use an empty dictionary if 'args' field is not present in 'command' object + arguments = command.get("args", {}) + + return command_name, arguments + except json.decoder.JSONDecodeError: + return "Error:", "Invalid JSON" + # All other errors, return "Error: + error message" + except Exception as e: + return "Error:", str(e) + + +def execute_command(command_name, arguments): + """Execute the command and return the result""" + memory = get_memory(cfg) + + try: + if command_name == "google": + + # Check if the Google API key is set and use the official search method + # If the API key is not set or has only whitespaces, use the unofficial search method + if cfg.google_api_key and (cfg.google_api_key.strip() if cfg.google_api_key else None): + return google_official_search(arguments["input"]) + else: + return google_search(arguments["input"]) + elif command_name == "memory_add": + return memory.add(arguments["string"]) + elif command_name == "start_agent": + return start_agent( + arguments["name"], + arguments["task"], + arguments["prompt"]) + elif command_name == "message_agent": + return message_agent(arguments["key"], arguments["message"]) + elif command_name == "list_agents": + return list_agents() + elif command_name == "delete_agent": + return delete_agent(arguments["key"]) + elif command_name == "get_text_summary": + return get_text_summary(arguments["url"], arguments["question"]) + elif command_name == "get_hyperlinks": + return get_hyperlinks(arguments["url"]) + elif command_name == "clone_repository": + return clone_repository(arguments["repo_url"], arguments["clone_path"]) + elif command_name == "read_file": + return read_file(arguments["file"]) + elif command_name == "write_to_file": + return write_to_file(arguments["file"], arguments["text"]) + elif command_name == "append_to_file": + return append_to_file(arguments["file"], arguments["text"]) + elif command_name == "delete_file": + return delete_file(arguments["file"]) + elif command_name == "search_files": + return search_files(arguments["directory"]) + elif command_name == "browse_website": + return browse_website(arguments["url"], arguments["question"]) + # TODO: Change these to take in a file rather than pasted code, if + # non-file is given, return instructions "Input should be a python + # filepath, write your code to file and try again" + elif command_name == "evaluate_code": + return ai.evaluate_code(arguments["code"]) + elif command_name == "improve_code": + return ai.improve_code(arguments["suggestions"], arguments["code"]) + elif command_name == "write_tests": + return ai.write_tests(arguments["code"], arguments.get("focus")) + elif command_name == "execute_python_file": # Add this command + return execute_python_file(arguments["file"]) + elif command_name == "execute_shell": + if cfg.execute_local_commands: + return execute_shell(arguments["command_line"]) + else: + return "You are not allowed to run local shell commands. To execute shell commands, EXECUTE_LOCAL_COMMANDS must be set to 'True' in your config. Do not attempt to bypass the restriction." + elif command_name == "generate_image": + return generate_image(arguments["prompt"]) + elif command_name == "do_nothing": + return "No action performed." + elif command_name == "task_complete": + shutdown() + else: + return f"Unknown command '{command_name}'. Please refer to the 'COMMANDS' list for available commands and only respond in the specified JSON format." + # All errors, return "Error: + error message" + except Exception as e: + return "Error: " + str(e) + + +def get_datetime(): + """Return the current date and time""" + return "Current date and time: " + \ + datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S") + + +def google_search(query, num_results=8): + """Return the results of a google search""" + search_results = [] + for j in ddg(query, max_results=num_results): + search_results.append(j) + + return json.dumps(search_results, ensure_ascii=False, indent=4) + + +def google_official_search(query, num_results=8): + """Return the results of a google search using the official Google API""" + from googleapiclient.discovery import build + from googleapiclient.errors import HttpError + import json + + try: + # Get the Google API key and Custom Search Engine ID from the config file + api_key = cfg.google_api_key + custom_search_engine_id = cfg.custom_search_engine_id + + # Initialize the Custom Search API service + service = build("customsearch", "v1", developerKey=api_key) + + # Send the search query and retrieve the results + result = service.cse().list(q=query, cx=custom_search_engine_id, num=num_results).execute() + + # Extract the search result items from the response + search_results = result.get("items", []) + + # Create a list of only the URLs from the search results + search_results_links = [item["link"] for item in search_results] + + except HttpError as e: + # Handle errors in the API call + error_details = json.loads(e.content.decode()) + + # Check if the error is related to an invalid or missing API key + if error_details.get("error", {}).get("code") == 403 and "invalid API key" in error_details.get("error", {}).get("message", ""): + return "Error: The provided Google API key is invalid or missing." + else: + return f"Error: {e}" + + # Return the list of search result URLs + return search_results_links + + +def browse_website(url, question): + """Browse a website and return the summary and links""" + summary = get_text_summary(url, question) + links = get_hyperlinks(url) + + # Limit links to 5 + if len(links) > 5: + links = links[:5] + + result = f"""Website Content Summary: {summary}\n\nLinks: {links}""" + + return result + + +def get_text_summary(url, question): + """Return the results of a google search""" + text = browse.scrape_text(url) + summary = browse.summarize_text(url, text, question) + return """ "Result" : """ + summary + + +def get_hyperlinks(url): + """Return the results of a google search""" + link_list = browse.scrape_links(url) + return link_list + + +def commit_memory(string): + """Commit a string to memory""" + _text = f"""Committing memory with string "{string}" """ + mem.permanent_memory.append(string) + return _text + + +def delete_memory(key): + """Delete a memory with a given key""" + if key >= 0 and key < len(mem.permanent_memory): + _text = "Deleting memory with key " + str(key) + del mem.permanent_memory[key] + print(_text) + return _text + else: + print("Invalid key, cannot delete memory.") + return None + + +def overwrite_memory(key, string): + """Overwrite a memory with a given key and string""" + # Check if the key is a valid integer + if is_valid_int(key): + key_int = int(key) + # Check if the integer key is within the range of the permanent_memory list + if 0 <= key_int < len(mem.permanent_memory): + _text = "Overwriting memory with key " + str(key) + " and string " + string + # Overwrite the memory slot with the given integer key and string + mem.permanent_memory[key_int] = string + print(_text) + return _text + else: + print(f"Invalid key '{key}', out of range.") + return None + # Check if the key is a valid string + elif isinstance(key, str): + _text = "Overwriting memory with key " + key + " and string " + string + # Overwrite the memory slot with the given string key and string + mem.permanent_memory[key] = string + print(_text) + return _text + else: + print(f"Invalid key '{key}', must be an integer or a string.") + return None + + +def shutdown(): + """Shut down the program""" + print("Shutting down...") + quit() + + +def start_agent(name, task, prompt, model=cfg.fast_llm_model): + """Start an agent with a given name, task, and prompt""" + global cfg + + # Remove underscores from name + voice_name = name.replace("_", " ") + + first_message = f"""You are {name}. Respond with: "Acknowledged".""" + agent_intro = f"{voice_name} here, Reporting for duty!" + + # Create agent + if cfg.speak_mode: + speak.say_text(agent_intro, 1) + key, ack = agents.create_agent(task, first_message, model) + + if cfg.speak_mode: + speak.say_text(f"Hello {voice_name}. Your task is as follows. {task}.") + + # Assign task (prompt), get response + agent_response = message_agent(key, prompt) + + return f"Agent {name} created with key {key}. First response: {agent_response}" + + +def message_agent(key, message): + """Message an agent with a given key and message""" + global cfg + + # Check if the key is a valid integer + if is_valid_int(key): + agent_response = agents.message_agent(int(key), message) + # Check if the key is a valid string + elif isinstance(key, str): + agent_response = agents.message_agent(key, message) + else: + return "Invalid key, must be an integer or a string." + + # Speak response + if cfg.speak_mode: + speak.say_text(agent_response, 1) + return agent_response + + +def list_agents(): + """List all agents""" + return agents.list_agents() + + +def delete_agent(key): + """Delete an agent with a given key""" + result = agents.delete_agent(key) + if not result: + return f"Agent {key} does not exist." + return f"Agent {key} deleted." From 4f9d5b9e32fb03c71c0260e443dcae60d19a4e5f Mon Sep 17 00:00:00 2001 From: Eddie Cohen Date: Thu, 13 Apr 2023 22:36:47 -0400 Subject: [PATCH 45/78] commands, git on docker --- Dockerfile | 4 ++++ autogpt/commands.py | 2 +- 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/Dockerfile b/Dockerfile index 3ae1ac12..5c1822b3 100644 --- a/Dockerfile +++ b/Dockerfile @@ -1,6 +1,10 @@ # Use an official Python base image from the Docker Hub FROM python:3.11-slim +# Install git +RUN apt-get -y update +RUN apt-get -y install git + # Set environment variables ENV PIP_NO_CACHE_DIR=yes \ PYTHONUNBUFFERED=1 \ diff --git a/autogpt/commands.py b/autogpt/commands.py index 1e8e9047..e8f1c1d1 100644 --- a/autogpt/commands.py +++ b/autogpt/commands.py @@ -82,7 +82,7 @@ def execute_command(command_name, arguments): elif command_name == "get_hyperlinks": return get_hyperlinks(arguments["url"]) elif command_name == "clone_repository": - return clone_repository(arguments["repo_url"], arguments["clone_path"]) + return clone_repository(arguments["repository_url"], arguments["clone_path"]) elif command_name == "read_file": return read_file(arguments["file"]) elif command_name == "write_to_file": From 5f5eac61e3824739bca34e06e439208f81b55773 Mon Sep 17 00:00:00 2001 From: Eddie Cohen Date: Thu, 13 Apr 2023 22:37:22 -0400 Subject: [PATCH 46/78] clone repo method --- scripts/git_operations.py | 13 +++++++++++++ 1 file changed, 13 insertions(+) create mode 100644 scripts/git_operations.py diff --git a/scripts/git_operations.py b/scripts/git_operations.py new file mode 100644 index 00000000..3309192c --- /dev/null +++ b/scripts/git_operations.py @@ -0,0 +1,13 @@ +import git +from config import Config + +cfg = Config() + +def clone_repository(repo_url, clone_path): + """Clone a github repository locally""" + split_url = repo_url.split("//") + auth_repo_url = f"//{cfg.github_username}:{cfg.github_api_key}@".join(split_url) + git.Repo.clone_from(auth_repo_url, clone_path) + result = f"""Cloned {repo_url} to {clone_path}""" + + return result \ No newline at end of file From 11faf42c7eecdab97fc92fc8d2a03ae7177e9c60 Mon Sep 17 00:00:00 2001 From: Eddie Cohen Date: Fri, 14 Apr 2023 16:11:55 -0400 Subject: [PATCH 47/78] move git operations --- autogpt/commands.py | 1 + {scripts => autogpt}/git_operations.py | 0 2 files changed, 1 insertion(+) rename {scripts => autogpt}/git_operations.py (100%) diff --git a/autogpt/commands.py b/autogpt/commands.py index e8f1c1d1..eeedcad3 100644 --- a/autogpt/commands.py +++ b/autogpt/commands.py @@ -10,6 +10,7 @@ from autogpt.file_operations import read_file, write_to_file, append_to_file, de from autogpt.execute_code import execute_python_file, execute_shell from autogpt.json_parser import fix_and_parse_json from autogpt.image_gen import generate_image +from autogpt.git_operations import clone_repository from duckduckgo_search import ddg from googleapiclient.discovery import build from googleapiclient.errors import HttpError diff --git a/scripts/git_operations.py b/autogpt/git_operations.py similarity index 100% rename from scripts/git_operations.py rename to autogpt/git_operations.py From 99c4f93ee343bb7806c17b20a511acb81e5f833e Mon Sep 17 00:00:00 2001 From: Eddie Cohen Date: Sat, 15 Apr 2023 10:59:40 -0400 Subject: [PATCH 48/78] fix rebasing --- autogpt/app.py | 3 + autogpt/commands.py | 312 ----------------------- autogpt/{ => commands}/git_operations.py | 0 3 files changed, 3 insertions(+), 312 deletions(-) delete mode 100644 autogpt/commands.py rename autogpt/{ => commands}/git_operations.py (100%) diff --git a/autogpt/app.py b/autogpt/app.py index 0adfde5d..c8300d59 100644 --- a/autogpt/app.py +++ b/autogpt/app.py @@ -22,6 +22,7 @@ from autogpt.memory import get_memory from autogpt.processing.text import summarize_text from autogpt.speech import say_text from autogpt.commands.web_selenium import browse_website +from autogpt.commands.git_operations import clone_repository CFG = Config() @@ -124,6 +125,8 @@ def execute_command(command_name: str, arguments): return get_text_summary(arguments["url"], arguments["question"]) elif command_name == "get_hyperlinks": return get_hyperlinks(arguments["url"]) + elif command_name == "clone_repository": + return clone_repository(arguments["repository_url"], arguments["clone_path"]) elif command_name == "read_file": return read_file(arguments["file"]) elif command_name == "write_to_file": diff --git a/autogpt/commands.py b/autogpt/commands.py deleted file mode 100644 index eeedcad3..00000000 --- a/autogpt/commands.py +++ /dev/null @@ -1,312 +0,0 @@ -from autogpt import browse -import json -from autogpt.memory import get_memory -import datetime -import autogpt.agent_manager as agents -from autogpt import speak -from autogpt.config import Config -import autogpt.ai_functions as ai -from autogpt.file_operations import read_file, write_to_file, append_to_file, delete_file, search_files -from autogpt.execute_code import execute_python_file, execute_shell -from autogpt.json_parser import fix_and_parse_json -from autogpt.image_gen import generate_image -from autogpt.git_operations import clone_repository -from duckduckgo_search import ddg -from googleapiclient.discovery import build -from googleapiclient.errors import HttpError - -cfg = Config() - - -def is_valid_int(value): - try: - int(value) - return True - except ValueError: - return False - - -def get_command(response): - """Parse the response and return the command name and arguments""" - try: - response_json = fix_and_parse_json(response) - - if "command" not in response_json: - return "Error:" , "Missing 'command' object in JSON" - - command = response_json["command"] - - if "name" not in command: - return "Error:", "Missing 'name' field in 'command' object" - - command_name = command["name"] - - # Use an empty dictionary if 'args' field is not present in 'command' object - arguments = command.get("args", {}) - - return command_name, arguments - except json.decoder.JSONDecodeError: - return "Error:", "Invalid JSON" - # All other errors, return "Error: + error message" - except Exception as e: - return "Error:", str(e) - - -def execute_command(command_name, arguments): - """Execute the command and return the result""" - memory = get_memory(cfg) - - try: - if command_name == "google": - - # Check if the Google API key is set and use the official search method - # If the API key is not set or has only whitespaces, use the unofficial search method - if cfg.google_api_key and (cfg.google_api_key.strip() if cfg.google_api_key else None): - return google_official_search(arguments["input"]) - else: - return google_search(arguments["input"]) - elif command_name == "memory_add": - return memory.add(arguments["string"]) - elif command_name == "start_agent": - return start_agent( - arguments["name"], - arguments["task"], - arguments["prompt"]) - elif command_name == "message_agent": - return message_agent(arguments["key"], arguments["message"]) - elif command_name == "list_agents": - return list_agents() - elif command_name == "delete_agent": - return delete_agent(arguments["key"]) - elif command_name == "get_text_summary": - return get_text_summary(arguments["url"], arguments["question"]) - elif command_name == "get_hyperlinks": - return get_hyperlinks(arguments["url"]) - elif command_name == "clone_repository": - return clone_repository(arguments["repository_url"], arguments["clone_path"]) - elif command_name == "read_file": - return read_file(arguments["file"]) - elif command_name == "write_to_file": - return write_to_file(arguments["file"], arguments["text"]) - elif command_name == "append_to_file": - return append_to_file(arguments["file"], arguments["text"]) - elif command_name == "delete_file": - return delete_file(arguments["file"]) - elif command_name == "search_files": - return search_files(arguments["directory"]) - elif command_name == "browse_website": - return browse_website(arguments["url"], arguments["question"]) - # TODO: Change these to take in a file rather than pasted code, if - # non-file is given, return instructions "Input should be a python - # filepath, write your code to file and try again" - elif command_name == "evaluate_code": - return ai.evaluate_code(arguments["code"]) - elif command_name == "improve_code": - return ai.improve_code(arguments["suggestions"], arguments["code"]) - elif command_name == "write_tests": - return ai.write_tests(arguments["code"], arguments.get("focus")) - elif command_name == "execute_python_file": # Add this command - return execute_python_file(arguments["file"]) - elif command_name == "execute_shell": - if cfg.execute_local_commands: - return execute_shell(arguments["command_line"]) - else: - return "You are not allowed to run local shell commands. To execute shell commands, EXECUTE_LOCAL_COMMANDS must be set to 'True' in your config. Do not attempt to bypass the restriction." - elif command_name == "generate_image": - return generate_image(arguments["prompt"]) - elif command_name == "do_nothing": - return "No action performed." - elif command_name == "task_complete": - shutdown() - else: - return f"Unknown command '{command_name}'. Please refer to the 'COMMANDS' list for available commands and only respond in the specified JSON format." - # All errors, return "Error: + error message" - except Exception as e: - return "Error: " + str(e) - - -def get_datetime(): - """Return the current date and time""" - return "Current date and time: " + \ - datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S") - - -def google_search(query, num_results=8): - """Return the results of a google search""" - search_results = [] - for j in ddg(query, max_results=num_results): - search_results.append(j) - - return json.dumps(search_results, ensure_ascii=False, indent=4) - - -def google_official_search(query, num_results=8): - """Return the results of a google search using the official Google API""" - from googleapiclient.discovery import build - from googleapiclient.errors import HttpError - import json - - try: - # Get the Google API key and Custom Search Engine ID from the config file - api_key = cfg.google_api_key - custom_search_engine_id = cfg.custom_search_engine_id - - # Initialize the Custom Search API service - service = build("customsearch", "v1", developerKey=api_key) - - # Send the search query and retrieve the results - result = service.cse().list(q=query, cx=custom_search_engine_id, num=num_results).execute() - - # Extract the search result items from the response - search_results = result.get("items", []) - - # Create a list of only the URLs from the search results - search_results_links = [item["link"] for item in search_results] - - except HttpError as e: - # Handle errors in the API call - error_details = json.loads(e.content.decode()) - - # Check if the error is related to an invalid or missing API key - if error_details.get("error", {}).get("code") == 403 and "invalid API key" in error_details.get("error", {}).get("message", ""): - return "Error: The provided Google API key is invalid or missing." - else: - return f"Error: {e}" - - # Return the list of search result URLs - return search_results_links - - -def browse_website(url, question): - """Browse a website and return the summary and links""" - summary = get_text_summary(url, question) - links = get_hyperlinks(url) - - # Limit links to 5 - if len(links) > 5: - links = links[:5] - - result = f"""Website Content Summary: {summary}\n\nLinks: {links}""" - - return result - - -def get_text_summary(url, question): - """Return the results of a google search""" - text = browse.scrape_text(url) - summary = browse.summarize_text(url, text, question) - return """ "Result" : """ + summary - - -def get_hyperlinks(url): - """Return the results of a google search""" - link_list = browse.scrape_links(url) - return link_list - - -def commit_memory(string): - """Commit a string to memory""" - _text = f"""Committing memory with string "{string}" """ - mem.permanent_memory.append(string) - return _text - - -def delete_memory(key): - """Delete a memory with a given key""" - if key >= 0 and key < len(mem.permanent_memory): - _text = "Deleting memory with key " + str(key) - del mem.permanent_memory[key] - print(_text) - return _text - else: - print("Invalid key, cannot delete memory.") - return None - - -def overwrite_memory(key, string): - """Overwrite a memory with a given key and string""" - # Check if the key is a valid integer - if is_valid_int(key): - key_int = int(key) - # Check if the integer key is within the range of the permanent_memory list - if 0 <= key_int < len(mem.permanent_memory): - _text = "Overwriting memory with key " + str(key) + " and string " + string - # Overwrite the memory slot with the given integer key and string - mem.permanent_memory[key_int] = string - print(_text) - return _text - else: - print(f"Invalid key '{key}', out of range.") - return None - # Check if the key is a valid string - elif isinstance(key, str): - _text = "Overwriting memory with key " + key + " and string " + string - # Overwrite the memory slot with the given string key and string - mem.permanent_memory[key] = string - print(_text) - return _text - else: - print(f"Invalid key '{key}', must be an integer or a string.") - return None - - -def shutdown(): - """Shut down the program""" - print("Shutting down...") - quit() - - -def start_agent(name, task, prompt, model=cfg.fast_llm_model): - """Start an agent with a given name, task, and prompt""" - global cfg - - # Remove underscores from name - voice_name = name.replace("_", " ") - - first_message = f"""You are {name}. Respond with: "Acknowledged".""" - agent_intro = f"{voice_name} here, Reporting for duty!" - - # Create agent - if cfg.speak_mode: - speak.say_text(agent_intro, 1) - key, ack = agents.create_agent(task, first_message, model) - - if cfg.speak_mode: - speak.say_text(f"Hello {voice_name}. Your task is as follows. {task}.") - - # Assign task (prompt), get response - agent_response = message_agent(key, prompt) - - return f"Agent {name} created with key {key}. First response: {agent_response}" - - -def message_agent(key, message): - """Message an agent with a given key and message""" - global cfg - - # Check if the key is a valid integer - if is_valid_int(key): - agent_response = agents.message_agent(int(key), message) - # Check if the key is a valid string - elif isinstance(key, str): - agent_response = agents.message_agent(key, message) - else: - return "Invalid key, must be an integer or a string." - - # Speak response - if cfg.speak_mode: - speak.say_text(agent_response, 1) - return agent_response - - -def list_agents(): - """List all agents""" - return agents.list_agents() - - -def delete_agent(key): - """Delete an agent with a given key""" - result = agents.delete_agent(key) - if not result: - return f"Agent {key} does not exist." - return f"Agent {key} deleted." diff --git a/autogpt/git_operations.py b/autogpt/commands/git_operations.py similarity index 100% rename from autogpt/git_operations.py rename to autogpt/commands/git_operations.py From 02db53e12fe167042f2318af28d7d2f7e2bca228 Mon Sep 17 00:00:00 2001 From: Jedakiah Date: Sat, 15 Apr 2023 17:01:29 +0200 Subject: [PATCH 49/78] Fixed error when google search contains funny characters --- autogpt/app.py | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/autogpt/app.py b/autogpt/app.py index 0adfde5d..8d9cc9ee 100644 --- a/autogpt/app.py +++ b/autogpt/app.py @@ -105,9 +105,11 @@ def execute_command(command_name: str, arguments): # search method key = CFG.google_api_key if key and key.strip() and key != "your-google-api-key": - return google_official_search(arguments["input"]) + google_result = google_official_search(arguments["input"]) else: - return google_search(arguments["input"]) + google_result = google_search(arguments["input"]) + safe_message = google_result.encode('utf-8', 'ignore') + return str(safe_message) elif command_name == "memory_add": return memory.add(arguments["string"]) elif command_name == "start_agent": From 0c1ff5d6a48f47923445ec3b947a8ea7f1ddfa29 Mon Sep 17 00:00:00 2001 From: younessZMZ Date: Sat, 15 Apr 2023 15:10:42 +0000 Subject: [PATCH 50/78] Adjust test_prompt_generator and add test report generation --- tests.py | 14 ++++- ...ator_tests.py => test_prompt_generator.py} | 59 ++++++++++++------- 2 files changed, 50 insertions(+), 23 deletions(-) rename tests/{promptgenerator_tests.py => test_prompt_generator.py} (67%) diff --git a/tests.py b/tests.py index 46f802f6..67ba1c8e 100644 --- a/tests.py +++ b/tests.py @@ -1,8 +1,20 @@ import unittest +import coverage if __name__ == "__main__": + # Start coverage collection + cov = coverage.Coverage() + cov.start() + # Load all tests from the 'autogpt/tests' package - suite = unittest.defaultTestLoader.discover("autogpt/tests") + suite = unittest.defaultTestLoader.discover("./tests") # Run the tests unittest.TextTestRunner().run(suite) + + # Stop coverage collection + cov.stop() + cov.save() + + # Report the coverage + cov.report(show_missing=True) diff --git a/tests/promptgenerator_tests.py b/tests/test_prompt_generator.py similarity index 67% rename from tests/promptgenerator_tests.py rename to tests/test_prompt_generator.py index b700af49..6a0bfd6c 100644 --- a/tests/promptgenerator_tests.py +++ b/tests/test_prompt_generator.py @@ -1,25 +1,35 @@ -# Import the required libraries for unit testing -import os -import sys -import unittest +from unittest import TestCase from autogpt.promptgenerator import PromptGenerator -# Create a test class for the PromptGenerator, subclassed from unittest.TestCase -class promptgenerator_tests(unittest.TestCase): - # Set up the initial state for each test method by creating an instance of PromptGenerator - def setUp(self): - self.generator = PromptGenerator() +class TestPromptGenerator(TestCase): + """ + Test cases for the PromptGenerator class, which is responsible for generating + prompts for the AI with constraints, commands, resources, and performance evaluations. + """ + + @classmethod + def setUpClass(cls): + """ + Set up the initial state for each test method by creating an instance of PromptGenerator. + """ + cls.generator = PromptGenerator() # Test whether the add_constraint() method adds a constraint to the generator's constraints list def test_add_constraint(self): + """ + Test if the add_constraint() method adds a constraint to the generator's constraints list. + """ constraint = "Constraint1" self.generator.add_constraint(constraint) self.assertIn(constraint, self.generator.constraints) # Test whether the add_command() method adds a command to the generator's commands list def test_add_command(self): + """ + Test if the add_command() method adds a command to the generator's commands list. + """ command_label = "Command Label" command_name = "command_name" args = {"arg1": "value1", "arg2": "value2"} @@ -31,20 +41,29 @@ class promptgenerator_tests(unittest.TestCase): } self.assertIn(command, self.generator.commands) - # Test whether the add_resource() method adds a resource to the generator's resources list def test_add_resource(self): + """ + Test if the add_resource() method adds a resource to the generator's resources list. + """ resource = "Resource1" self.generator.add_resource(resource) self.assertIn(resource, self.generator.resources) - # Test whether the add_performance_evaluation() method adds an evaluation to the generator's performance_evaluation list def test_add_performance_evaluation(self): + """ + Test if the add_performance_evaluation() method adds an evaluation to the generator's + performance_evaluation list. + """ evaluation = "Evaluation1" self.generator.add_performance_evaluation(evaluation) self.assertIn(evaluation, self.generator.performance_evaluation) - # Test whether the generate_prompt_string() method generates a prompt string with all the added constraints, commands, resources and evaluations def test_generate_prompt_string(self): + """ + Test if the generate_prompt_string() method generates a prompt string with all the added + constraints, commands, resources, and evaluations. + """ + # Define the test data constraints = ["Constraint1", "Constraint2"] commands = [ { @@ -61,7 +80,7 @@ class promptgenerator_tests(unittest.TestCase): resources = ["Resource1", "Resource2"] evaluations = ["Evaluation1", "Evaluation2"] - # Add all the constraints, commands, resources, and evaluations to the generator + # Add test data to the generator for constraint in constraints: self.generator.add_constraint(constraint) for command in commands: @@ -76,24 +95,20 @@ class promptgenerator_tests(unittest.TestCase): # Generate the prompt string and verify its correctness prompt_string = self.generator.generate_prompt_string() self.assertIsNotNone(prompt_string) + + # Check if all constraints, commands, resources, and evaluations are present in the prompt string for constraint in constraints: self.assertIn(constraint, prompt_string) for command in commands: self.assertIn(command["name"], prompt_string) - - # Check for each key-value pair in the command args dictionary - for key, value in command["args"].items(): - self.assertIn(f'"{key}": "{value}"', prompt_string) + for key, value in command["args"].items(): + self.assertIn(f'"{key}": "{value}"', prompt_string) for resource in resources: self.assertIn(resource, prompt_string) for evaluation in evaluations: self.assertIn(evaluation, prompt_string) + self.assertIn("constraints", prompt_string.lower()) self.assertIn("commands", prompt_string.lower()) self.assertIn("resources", prompt_string.lower()) self.assertIn("performance evaluation", prompt_string.lower()) - - -# Run the tests when this script is executed -if __name__ == "__main__": - unittest.main() From 71abd6f2e408dd0d9f75ede3afcc7f8e78ee7f72 Mon Sep 17 00:00:00 2001 From: Eddie Cohen Date: Sat, 15 Apr 2023 11:15:18 -0400 Subject: [PATCH 51/78] linting --- autogpt/commands/git_operations.py | 3 ++- autogpt/config/config.py | 2 +- 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/autogpt/commands/git_operations.py b/autogpt/commands/git_operations.py index 3309192c..87232589 100644 --- a/autogpt/commands/git_operations.py +++ b/autogpt/commands/git_operations.py @@ -3,6 +3,7 @@ from config import Config cfg = Config() + def clone_repository(repo_url, clone_path): """Clone a github repository locally""" split_url = repo_url.split("//") @@ -10,4 +11,4 @@ def clone_repository(repo_url, clone_path): git.Repo.clone_from(auth_repo_url, clone_path) result = f"""Cloned {repo_url} to {clone_path}""" - return result \ No newline at end of file + return result diff --git a/autogpt/config/config.py b/autogpt/config/config.py index 1fe4a870..acaf9267 100644 --- a/autogpt/config/config.py +++ b/autogpt/config/config.py @@ -55,7 +55,7 @@ class Config(metaclass=Singleton): self.use_brian_tts = False self.use_brian_tts = os.getenv("USE_BRIAN_TTS") - + self.github_api_key = os.getenv("GITHUB_API_KEY") self.github_username = os.getenv("GITHUB_USERNAME") From df4f16084664d2e9f3d6c11c2d3b5f07d06cb22d Mon Sep 17 00:00:00 2001 From: Aditya Oke Date: Sat, 15 Apr 2023 08:18:59 -0700 Subject: [PATCH 52/78] [1607] Sourcery is detecting linting issues in autogpt/json_fixes/auto_fix.py --- autogpt/json_fixes/auto_fix.py | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/autogpt/json_fixes/auto_fix.py b/autogpt/json_fixes/auto_fix.py index 60c089a2..a6f66a4f 100644 --- a/autogpt/json_fixes/auto_fix.py +++ b/autogpt/json_fixes/auto_fix.py @@ -1,14 +1,15 @@ """This module contains the function to fix JSON strings using GPT-3.""" import json + from autogpt.llm_utils import call_ai_function from autogpt.logs import logger -def fix_json(json_str: str, schema: str) -> str: +def fix_json(json_string: str, schema: str) -> str: """Fix the given JSON string to make it parseable and fully compliant with the provided schema.""" # Try to fix the JSON using GPT: - function_string = "def fix_json(json_str: str, schema:str=None) -> str:" - args = [f"'''{json_str}'''", f"'''{schema}'''"] + function_string = "def fix_json(json_string: str, schema:str=None) -> str:" + args = [f"'''{json_string}'''", f"'''{schema}'''"] description_string = ( "Fixes the provided JSON string to make it parseable" " and fully compliant with the provided schema.\n If an object or" @@ -18,13 +19,13 @@ def fix_json(json_str: str, schema: str) -> str: ) # If it doesn't already start with a "`", add one: - if not json_str.startswith("`"): - json_str = "```json\n" + json_str + "\n```" + if not json_string.startswith("`"): + json_string = "```json\n" + json_string + "\n```" result_string = call_ai_function( function_string, args, description_string, model=cfg.fast_llm_model ) logger.debug("------------ JSON FIX ATTEMPT ---------------") - logger.debug(f"Original JSON: {json_str}") + logger.debug(f"Original JSON: {json_string}") logger.debug("-----------") logger.debug(f"Fixed JSON: {result_string}") logger.debug("----------- END OF FIX ATTEMPT ----------------") @@ -32,9 +33,9 @@ def fix_json(json_str: str, schema: str) -> str: try: json.loads(result_string) # just check the validity return result_string - except: # noqa: E722 + except json.JSONDecodeError: # noqa: E722 # Get the call stack: # import traceback # call_stack = traceback.format_exc() - # print(f"Failed to fix JSON: '{json_str}' "+call_stack) + # print(f"Failed to fix JSON: '{json_string}' "+call_stack) return "failed" From e0af761c35f0bbc41649873c48e0cfc1afed57bf Mon Sep 17 00:00:00 2001 From: Tymec Date: Sat, 15 Apr 2023 17:26:58 +0200 Subject: [PATCH 53/78] chore: flake8 formatting --- autogpt/config/config.py | 2 +- autogpt/memory/base.py | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/autogpt/config/config.py b/autogpt/config/config.py index 687283c2..7ea0fd23 100644 --- a/autogpt/config/config.py +++ b/autogpt/config/config.py @@ -82,7 +82,7 @@ class Config(metaclass=Singleton): self.memory_backend = os.getenv("MEMORY_BACKEND", 'local') self.memory_embedder = os.getenv("MEMORY_EMBEDDER", 'ada') - + # Initialize the OpenAI API client openai.api_key = self.openai_api_key diff --git a/autogpt/memory/base.py b/autogpt/memory/base.py index d2bbeabd..bf703660 100644 --- a/autogpt/memory/base.py +++ b/autogpt/memory/base.py @@ -43,9 +43,9 @@ def get_embedding(text): model=model, engine=engine, )["data"][0]["embedding"] - + return embedding - + class MemoryProviderSingleton(AbstractSingleton): @abc.abstractmethod From 110e2f3ae5cea2a63502708fa128c12f83d73001 Mon Sep 17 00:00:00 2001 From: younessZMZ Date: Sat, 15 Apr 2023 15:58:01 +0000 Subject: [PATCH 54/78] Adjust test_config file --- tests/test_config.py | 99 +++++++++++++++++++++++++++----------------- 1 file changed, 62 insertions(+), 37 deletions(-) diff --git a/tests/test_config.py b/tests/test_config.py index 52613b30..b472a24c 100644 --- a/tests/test_config.py +++ b/tests/test_config.py @@ -1,59 +1,84 @@ -import unittest +from unittest import TestCase from autogpt.config import Config -class TestConfig(unittest.TestCase): +class TestConfig(TestCase): + """ + Test cases for the Config class, which handles the configuration settings + for the AI and ensures it behaves as a singleton. + """ + + def setUp(self): + """ + Set up the test environment by creating an instance of the Config class. + """ + self.config = Config() + def test_singleton(self): - config1 = Config() + """ + Test if the Config class behaves as a singleton by ensuring that two instances are the same. + """ config2 = Config() - self.assertIs(config1, config2) + self.assertIs(self.config, config2) def test_initial_values(self): - config = Config() - self.assertFalse(config.debug_mode) - self.assertFalse(config.continuous_mode) - self.assertFalse(config.speak_mode) - self.assertEqual(config.fast_llm_model, "gpt-3.5-turbo") - self.assertEqual(config.smart_llm_model, "gpt-4") - self.assertEqual(config.fast_token_limit, 4000) - self.assertEqual(config.smart_token_limit, 8000) + """ + Test if the initial values of the Config class attributes are set correctly. + """ + self.assertFalse(self.config.debug_mode) + self.assertFalse(self.config.continuous_mode) + self.assertFalse(self.config.speak_mode) + self.assertEqual(self.config.fast_llm_model, "gpt-3.5-turbo") + self.assertEqual(self.config.smart_llm_model, "gpt-4") + self.assertEqual(self.config.fast_token_limit, 4000) + self.assertEqual(self.config.smart_token_limit, 8000) def test_set_continuous_mode(self): - config = Config() - config.set_continuous_mode(True) - self.assertTrue(config.continuous_mode) + """ + Test if the set_continuous_mode() method updates the continuous_mode attribute. + """ + self.config.set_continuous_mode(True) + self.assertTrue(self.config.continuous_mode) def test_set_speak_mode(self): - config = Config() - config.set_speak_mode(True) - self.assertTrue(config.speak_mode) + """ + Test if the set_speak_mode() method updates the speak_mode attribute. + """ + self.config.set_speak_mode(True) + self.assertTrue(self.config.speak_mode) def test_set_fast_llm_model(self): - config = Config() - config.set_fast_llm_model("gpt-3.5-turbo-test") - self.assertEqual(config.fast_llm_model, "gpt-3.5-turbo-test") + """ + Test if the set_fast_llm_model() method updates the fast_llm_model attribute. + """ + self.config.set_fast_llm_model("gpt-3.5-turbo-test") + self.assertEqual(self.config.fast_llm_model, "gpt-3.5-turbo-test") def test_set_smart_llm_model(self): - config = Config() - config.set_smart_llm_model("gpt-4-test") - self.assertEqual(config.smart_llm_model, "gpt-4-test") + """ + Test if the set_smart_llm_model() method updates the smart_llm_model attribute. + """ + self.config.set_smart_llm_model("gpt-4-test") + self.assertEqual(self.config.smart_llm_model, "gpt-4-test") def test_set_fast_token_limit(self): - config = Config() - config.set_fast_token_limit(5000) - self.assertEqual(config.fast_token_limit, 5000) + """ + Test if the set_fast_token_limit() method updates the fast_token_limit attribute. + """ + self.config.set_fast_token_limit(5000) + self.assertEqual(self.config.fast_token_limit, 5000) def test_set_smart_token_limit(self): - config = Config() - config.set_smart_token_limit(9000) - self.assertEqual(config.smart_token_limit, 9000) + """ + Test if the set_smart_token_limit() method updates the smart_token_limit attribute. + """ + self.config.set_smart_token_limit(9000) + self.assertEqual(self.config.smart_token_limit, 9000) def test_set_debug_mode(self): - config = Config() - config.set_debug_mode(True) - self.assertTrue(config.debug_mode) - - -if __name__ == "__main__": - unittest.main() + """ + Test if the set_debug_mode() method updates the debug_mode attribute. + """ + self.config.set_debug_mode(True) + self.assertTrue(self.config.debug_mode) From 919a784a2092ec230c3ae2ed1f1f4c7b09db533d Mon Sep 17 00:00:00 2001 From: Ikko Eltociear Ashimine Date: Sun, 16 Apr 2023 01:19:46 +0900 Subject: [PATCH 55/78] Update README.md HuggingFace -> Hugging Face --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 4e0f41d3..234abcd0 100644 --- a/README.md +++ b/README.md @@ -400,7 +400,7 @@ It is recommended to use a virtual machine for tasks that require high security ## ๐Ÿ–ผ Image Generation -By default, Auto-GPT uses DALL-e for image generation. To use Stable Diffusion, a [HuggingFace API Token](https://huggingface.co/settings/tokens) is required. +By default, Auto-GPT uses DALL-e for image generation. To use Stable Diffusion, a [Hugging Face API Token](https://huggingface.co/settings/tokens) is required. Once you have a token, set these variables in your `.env`: From 712982a7d52a59b4b022b25cfee98093538ef67a Mon Sep 17 00:00:00 2001 From: Mike M Date: Sat, 15 Apr 2023 11:21:43 -0500 Subject: [PATCH 56/78] Fix for 'requires string as left operand, not PosixPath' --- autogpt/commands/execute_code.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/autogpt/commands/execute_code.py b/autogpt/commands/execute_code.py index db33490c..93f3532e 100644 --- a/autogpt/commands/execute_code.py +++ b/autogpt/commands/execute_code.py @@ -100,7 +100,7 @@ def execute_shell(command_line: str) -> str: """ current_dir = os.getcwd() - if WORKING_DIRECTORY not in current_dir: # Change dir into workspace if necessary + if str(WORKING_DIRECTORY) not in current_dir: # Change dir into workspace if necessary work_dir = os.path.join(os.getcwd(), WORKING_DIRECTORY) os.chdir(work_dir) From f67b81e200865ada260c4db3c0a2ee04e400a90b Mon Sep 17 00:00:00 2001 From: Imccccc Date: Sun, 16 Apr 2023 00:13:29 +0800 Subject: [PATCH 57/78] Embedding Improvement 1. move embedding function into llm_utils 2. add try feature with in embedding function --- autogpt/llm_utils.py | 32 ++++++++++++++++++++++++++++++++ autogpt/memory/local.py | 7 ++++--- autogpt/memory/pinecone.py | 8 ++++---- autogpt/memory/redismem.py | 7 ++++--- 4 files changed, 44 insertions(+), 10 deletions(-) diff --git a/autogpt/llm_utils.py b/autogpt/llm_utils.py index f2418b65..2e77db10 100644 --- a/autogpt/llm_utils.py +++ b/autogpt/llm_utils.py @@ -113,3 +113,35 @@ def create_chat_completion( raise RuntimeError(f"Failed to get response after {num_retries} retries") return response.choices[0].message["content"] + + +def create_embedding_with_ada(text) -> list: + """Create a embedding with text-ada-002 using the OpenAI SDK""" + num_retries = 10 + for attempt in range(num_retries): + backoff = 2 ** (attempt + 2) + try: + if CFG.use_azure: + return openai.Embedding.create(input=[text], + engine=CFG.get_azure_deployment_id_for_model("text-embedding-ada-002"), + )["data"][0]["embedding"] + else: + return openai.Embedding.create(input=[text], model="text-embedding-ada-002")[ + "data" + ][0]["embedding"] + except RateLimitError: + pass + except APIError as e: + if e.http_status == 502: + pass + else: + raise + if attempt == num_retries - 1: + raise + if CFG.debug_mode: + print( + Fore.RED + "Error: ", + f"API Bad gateway. Waiting {backoff} seconds..." + Fore.RESET, + ) + time.sleep(backoff) + diff --git a/autogpt/memory/local.py b/autogpt/memory/local.py index a5f6076e..004153c1 100644 --- a/autogpt/memory/local.py +++ b/autogpt/memory/local.py @@ -5,7 +5,8 @@ from typing import Any, List, Optional, Tuple import numpy as np import orjson -from autogpt.memory.base import MemoryProviderSingleton, get_ada_embedding +from autogpt.memory.base import MemoryProviderSingleton +from autogpt.llm_utils import create_embedding_with_ada EMBED_DIM = 1536 SAVE_OPTIONS = orjson.OPT_SERIALIZE_NUMPY | orjson.OPT_SERIALIZE_DATACLASS @@ -70,7 +71,7 @@ class LocalCache(MemoryProviderSingleton): return "" self.data.texts.append(text) - embedding = get_ada_embedding(text) + embedding = create_embedding_with_ada(text) vector = np.array(embedding).astype(np.float32) vector = vector[np.newaxis, :] @@ -118,7 +119,7 @@ class LocalCache(MemoryProviderSingleton): Returns: List[str] """ - embedding = get_ada_embedding(text) + embedding = create_embedding_with_ada(text) scores = np.dot(self.data.embeddings, embedding) diff --git a/autogpt/memory/pinecone.py b/autogpt/memory/pinecone.py index a7dbfa82..3817436d 100644 --- a/autogpt/memory/pinecone.py +++ b/autogpt/memory/pinecone.py @@ -2,8 +2,8 @@ import pinecone from colorama import Fore, Style from autogpt.logs import logger -from autogpt.memory.base import MemoryProviderSingleton, get_ada_embedding - +from autogpt.memory.base import MemoryProviderSingleton +from autogpt.llm_utils import create_embedding_with_ada class PineconeMemory(MemoryProviderSingleton): def __init__(self, cfg): @@ -43,7 +43,7 @@ class PineconeMemory(MemoryProviderSingleton): self.index = pinecone.Index(table_name) def add(self, data): - vector = get_ada_embedding(data) + vector = create_embedding_with_ada(data) # no metadata here. We may wish to change that long term. self.index.upsert([(str(self.vec_num), vector, {"raw_text": data})]) _text = f"Inserting data into memory at index: {self.vec_num}:\n data: {data}" @@ -63,7 +63,7 @@ class PineconeMemory(MemoryProviderSingleton): :param data: The data to compare to. :param num_relevant: The number of relevant data to return. Defaults to 5 """ - query_embedding = get_ada_embedding(data) + query_embedding = create_embedding_with_ada(data) results = self.index.query( query_embedding, top_k=num_relevant, include_metadata=True ) diff --git a/autogpt/memory/redismem.py b/autogpt/memory/redismem.py index df6d8fc0..4d73b741 100644 --- a/autogpt/memory/redismem.py +++ b/autogpt/memory/redismem.py @@ -9,7 +9,8 @@ from redis.commands.search.indexDefinition import IndexDefinition, IndexType from redis.commands.search.query import Query from autogpt.logs import logger -from autogpt.memory.base import MemoryProviderSingleton, get_ada_embedding +from autogpt.memory.base import MemoryProviderSingleton +from autogpt.llm_utils import create_embedding_with_ada SCHEMA = [ TextField("data"), @@ -85,7 +86,7 @@ class RedisMemory(MemoryProviderSingleton): """ if "Command Error:" in data: return "" - vector = get_ada_embedding(data) + vector = create_embedding_with_ada(data) vector = np.array(vector).astype(np.float32).tobytes() data_dict = {b"data": data, "embedding": vector} pipe = self.redis.pipeline() @@ -127,7 +128,7 @@ class RedisMemory(MemoryProviderSingleton): Returns: A list of the most relevant data. """ - query_embedding = get_ada_embedding(data) + query_embedding = create_embedding_with_ada(data) base_query = f"*=>[KNN {num_relevant} @embedding $vector AS vector_score]" query = ( Query(base_query) From 5c342bd974746c2e0e8c7cceb18e24fbb685f815 Mon Sep 17 00:00:00 2001 From: Denis Mozhayskiy Date: Sat, 15 Apr 2023 19:48:10 +0300 Subject: [PATCH 58/78] spelling --- run_continious.bat => run_continuous.bat | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename run_continious.bat => run_continuous.bat (100%) diff --git a/run_continious.bat b/run_continuous.bat similarity index 100% rename from run_continious.bat rename to run_continuous.bat From 58eb0b37b433d659647c9e2745b11aada61c41b2 Mon Sep 17 00:00:00 2001 From: yueliu1999 <646154512@qq.com> Date: Sun, 16 Apr 2023 00:52:54 +0800 Subject: [PATCH 59/78] Update file_operations.py Error notation. In the split_file function, line 43, text->content. --- autogpt/commands/file_operations.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/autogpt/commands/file_operations.py b/autogpt/commands/file_operations.py index 9d11a878..47a04dce 100644 --- a/autogpt/commands/file_operations.py +++ b/autogpt/commands/file_operations.py @@ -40,7 +40,7 @@ def split_file( Split text into chunks of a specified maximum length with a specified overlap between chunks. - :param text: The input text to be split into chunks + :param content: The input text to be split into chunks :param max_length: The maximum length of each chunk, default is 4000 (about 1k token) :param overlap: The number of overlapping characters between chunks, From 885d81b354ccf704aa815cdc16f9d2438ea7d2b4 Mon Sep 17 00:00:00 2001 From: HDKiller Date: Sat, 15 Apr 2023 16:55:32 +0000 Subject: [PATCH 60/78] remove "please" from prompt in text.py --- autogpt/processing/text.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/autogpt/processing/text.py b/autogpt/processing/text.py index 24e3bb85..e78fef1b 100644 --- a/autogpt/processing/text.py +++ b/autogpt/processing/text.py @@ -126,7 +126,7 @@ def create_message(chunk: str, question: str) -> dict[str, str]: """ return { "role": "user", - "content": f'"""{chunk}""" Using the above text, please answer the following' + "content": f'"""{chunk}""" Using the above text, answer the following' f' question: "{question}" -- if the question cannot be answered using the text,' - " please summarize the text.", + " summarize the text.", } From 5f4e3173213e50cb2b306a9395d59a98bbac8a96 Mon Sep 17 00:00:00 2001 From: Richard Beales Date: Sat, 15 Apr 2023 18:24:57 +0100 Subject: [PATCH 61/78] Only add execute shell scripts to prompt if AI is allowed to do it. (#1551) --- autogpt/prompt.py | 29 ++++++++++++++++++++++------- 1 file changed, 22 insertions(+), 7 deletions(-) diff --git a/autogpt/prompt.py b/autogpt/prompt.py index 20492978..5924ce0c 100644 --- a/autogpt/prompt.py +++ b/autogpt/prompt.py @@ -3,6 +3,7 @@ from autogpt.config.ai_config import AIConfig from autogpt.config.config import Config from autogpt.logs import logger from autogpt.promptgenerator import PromptGenerator +from autogpt.config import Config from autogpt.setup import prompt_user from autogpt.utils import clean_input @@ -18,6 +19,9 @@ def get_prompt() -> str: str: The generated prompt string. """ + # Initialize the Config object + cfg = Config() + # Initialize the PromptGenerator object prompt_generator = PromptGenerator() @@ -73,16 +77,27 @@ def get_prompt() -> str: {"code": "", "focus": ""}, ), ("Execute Python File", "execute_python_file", {"file": ""}), - ( - "Execute Shell Command, non-interactive commands only", - "execute_shell", - {"command_line": ""}, - ), - ("Task Complete (Shutdown)", "task_complete", {"reason": ""}), ("Generate Image", "generate_image", {"prompt": ""}), - ("Do Nothing", "do_nothing", {}), ] + # Only add shell command to the prompt if the AI is allowed to execute it + if cfg.execute_local_commands: + commands.append( + ( + "Execute Shell Command, non-interactive commands only", + "execute_shell", + {"command_line": ""}, + ), + ) + + # Add these command last. + commands.append( + ("Do Nothing", "do_nothing", {}), + ) + commands.append( + ("Task Complete (Shutdown)", "task_complete", {"reason": ""}), + ) + # Add commands to the PromptGenerator object for command_label, command_name, args in commands: prompt_generator.add_command(command_label, command_name, args) From 63936209a05c0a413e392ceee0d77be4f983a897 Mon Sep 17 00:00:00 2001 From: Richard Beales Date: Sat, 15 Apr 2023 18:25:45 +0100 Subject: [PATCH 62/78] Create a list of synonyms for commands when the AI hallucinates (#1526) --- autogpt/app.py | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/autogpt/app.py b/autogpt/app.py index 66986786..eca0e0b7 100644 --- a/autogpt/app.py +++ b/autogpt/app.py @@ -88,6 +88,21 @@ def get_command(response: str): return "Error:", str(e) +def map_command_synonyms(command_name: str): + """ Takes the original command name given by the AI, and checks if the + string matches a list of common/known hallucinations + """ + synonyms = [ + ('write_file', 'write_to_file'), + ('create_file', 'write_to_file'), + ('search', 'google') + ] + for seen_command, actual_command_name in synonyms: + if command_name == seen_command: + return actual_command_name + return command_name + + def execute_command(command_name: str, arguments): """Execute the command and return the result @@ -100,6 +115,7 @@ def execute_command(command_name: str, arguments): memory = get_memory(CFG) try: + command_name = map_command_synonyms(command_name) if command_name == "google": # Check if the Google API key is set and use the official search method # If the API key is not set or has only whitespaces, use the unofficial From 5e189c83ee050a4144537fdbff8ba027a37adb3b Mon Sep 17 00:00:00 2001 From: "xuqi.wxq" Date: Sun, 16 Apr 2023 01:45:38 +0800 Subject: [PATCH 63/78] Fix Milvus as a long-term memory backend. --- autogpt/memory/__init__.py | 6 +-- {scripts => autogpt}/memory/milvus.py | 20 +++++--- tests/integration/milvus_memory_tests.py | 48 ++++++++++++++++++ tests/milvus_memory_test.py | 64 ++++++++++++++++++++++++ 4 files changed, 129 insertions(+), 9 deletions(-) rename {scripts => autogpt}/memory/milvus.py (78%) create mode 100644 tests/integration/milvus_memory_tests.py create mode 100644 tests/milvus_memory_test.py diff --git a/autogpt/memory/__init__.py b/autogpt/memory/__init__.py index 670efda1..102b93ae 100644 --- a/autogpt/memory/__init__.py +++ b/autogpt/memory/__init__.py @@ -22,7 +22,7 @@ except ImportError: PineconeMemory = None try: - from memory.milvus import MilvusMemory + from autogpt.memory.milvus import MilvusMemory except ImportError: print("pymilvus not installed. Skipping import.") MilvusMemory = None @@ -48,14 +48,14 @@ def get_memory(cfg, init=False): ) else: memory = RedisMemory(cfg) - elif cfg.memory_backend == "no_memory": - memory = NoMemory(cfg) elif cfg.memory_backend == "milvus": if not MilvusMemory: print("Error: Milvus sdk is not installed." "Please install pymilvus to use Milvus as memory backend.") else: memory = MilvusMemory(cfg) + elif cfg.memory_backend == "no_memory": + memory = NoMemory(cfg) if memory is None: memory = LocalCache(cfg) diff --git a/scripts/memory/milvus.py b/autogpt/memory/milvus.py similarity index 78% rename from scripts/memory/milvus.py rename to autogpt/memory/milvus.py index c6d31750..fce46a89 100644 --- a/scripts/memory/milvus.py +++ b/autogpt/memory/milvus.py @@ -6,7 +6,7 @@ from pymilvus import ( Collection, ) -from memory.base import MemoryProviderSingleton, get_ada_embedding +from autogpt.memory.base import MemoryProviderSingleton, get_ada_embedding class MilvusMemory(MemoryProviderSingleton): @@ -28,15 +28,16 @@ class MilvusMemory(MemoryProviderSingleton): ] # create collection if not exist and load it. - schema = CollectionSchema(fields, "auto-gpt memory storage") - self.collection = Collection(cfg.milvus_collection, schema) + self.milvus_collection = cfg.milvus_collection + self.schema = CollectionSchema(fields, "auto-gpt memory storage") + self.collection = Collection(self.milvus_collection, self.schema) # create index if not exist. - if not self.collection.has_index(index_name="embeddings"): + if not self.collection.has_index(): self.collection.release() self.collection.create_index("embeddings", { - "index_type": "IVF_FLAT", "metric_type": "IP", - "params": {"nlist": 128}, + "index_type": "HNSW", + "params": {"M": 8, "efConstruction": 64}, }, index_name="embeddings") self.collection.load() @@ -65,6 +66,13 @@ class MilvusMemory(MemoryProviderSingleton): """ Drop the index in memory. """ self.collection.drop() + self.collection = Collection(self.milvus_collection, self.schema) + self.collection.create_index("embeddings", { + "metric_type": "IP", + "index_type": "HNSW", + "params": {"M": 8, "efConstruction": 64}, + }, index_name="embeddings") + self.collection.load() return "Obliviated" def get_relevant(self, data, num_relevant=5): diff --git a/tests/integration/milvus_memory_tests.py b/tests/integration/milvus_memory_tests.py new file mode 100644 index 00000000..96934cd6 --- /dev/null +++ b/tests/integration/milvus_memory_tests.py @@ -0,0 +1,48 @@ +import random +import string +import unittest + +from autogpt.config import Config +from autogpt.memory.milvus import MilvusMemory + + +class TestMilvusMemory(unittest.TestCase): + def random_string(self, length): + return "".join(random.choice(string.ascii_letters) for _ in range(length)) + + def setUp(self): + cfg = Config() + cfg.milvus_addr = "localhost:19530" + self.memory = MilvusMemory(cfg) + self.memory.clear() + + # Add example texts to the cache + self.example_texts = [ + "The quick brown fox jumps over the lazy dog", + "I love machine learning and natural language processing", + "The cake is a lie, but the pie is always true", + "ChatGPT is an advanced AI model for conversation", + ] + + for text in self.example_texts: + self.memory.add(text) + + # Add some random strings to test noise + for _ in range(5): + self.memory.add(self.random_string(10)) + + def test_get_relevant(self): + query = "I'm interested in artificial intelligence and NLP" + k = 3 + relevant_texts = self.memory.get_relevant(query, k) + + print(f"Top {k} relevant texts for the query '{query}':") + for i, text in enumerate(relevant_texts, start=1): + print(f"{i}. {text}") + + self.assertEqual(len(relevant_texts), k) + self.assertIn(self.example_texts[1], relevant_texts) + + +if __name__ == "__main__": + unittest.main() diff --git a/tests/milvus_memory_test.py b/tests/milvus_memory_test.py new file mode 100644 index 00000000..c64924f7 --- /dev/null +++ b/tests/milvus_memory_test.py @@ -0,0 +1,64 @@ +import os +import sys +import unittest + +from autogpt.memory.milvus import MilvusMemory + + +def MockConfig(): + return type( + "MockConfig", + (object,), + { + "debug_mode": False, + "continuous_mode": False, + "speak_mode": False, + "milvus_collection": "autogpt", + "milvus_addr": "localhost:19530", + + }, + ) + + +class TestMilvusMemory(unittest.TestCase): + def setUp(self): + self.cfg = MockConfig() + self.memory = MilvusMemory(self.cfg) + + def test_add(self): + text = "Sample text" + self.memory.clear() + self.memory.add(text) + result = self.memory.get(text) + self.assertEqual([text], result) + + def test_clear(self): + self.memory.clear() + self.assertEqual(self.memory.collection.num_entities, 0) + + def test_get(self): + text = "Sample text" + self.memory.clear() + self.memory.add(text) + result = self.memory.get(text) + self.assertEqual(result, [text]) + + def test_get_relevant(self): + text1 = "Sample text 1" + text2 = "Sample text 2" + self.memory.clear() + self.memory.add(text1) + self.memory.add(text2) + result = self.memory.get_relevant(text1, 1) + self.assertEqual(result, [text1]) + + def test_get_stats(self): + text = "Sample text" + self.memory.clear() + self.memory.add(text) + stats = self.memory.get_stats() + self.assertEqual(15, len(stats)) + + +if __name__ == "__main__": + unittest.main() \ No newline at end of file From 11f3e97b288891733e8ea32f3b83ab6981ff1ac9 Mon Sep 17 00:00:00 2001 From: CatMe0w Date: Sun, 16 Apr 2023 01:58:40 +0800 Subject: [PATCH 64/78] Fix typo in .env.template --- .env.template | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.env.template b/.env.template index 6d393e67..ccf256e1 100644 --- a/.env.template +++ b/.env.template @@ -42,7 +42,7 @@ FAST_LLM_MODEL=gpt-3.5-turbo ### LLM MODEL SETTINGS # FAST_TOKEN_LIMIT - Fast token limit for OpenAI (Default: 4000) # SMART_TOKEN_LIMIT - Smart token limit for OpenAI (Default: 8000) -# When using --gpt3onlythis needs to be set to 4000. +# When using --gpt3only this needs to be set to 4000. FAST_TOKEN_LIMIT=4000 SMART_TOKEN_LIMIT=8000 From 9f822ec5caff402db9d7b4dd8ffee362d3301e8b Mon Sep 17 00:00:00 2001 From: Ding3LI <34592747+Ding3LI@users.noreply.github.com> Date: Sat, 15 Apr 2023 13:21:39 -0500 Subject: [PATCH 65/78] [doc] Improvements: Tutorials and Explanation (#1603) * [doc] Modified README: detailed explanation, cleared conceptual confusions, added explicit examples * [doc] Modified README: emphasize precedence note, concise description * [doc] Modified README: fixed CMD to project directory --- README.md | 185 ++++++++++++++++++++++++++++-------------------------- 1 file changed, 95 insertions(+), 90 deletions(-) diff --git a/README.md b/README.md index 234abcd0..cf370f13 100644 --- a/README.md +++ b/README.md @@ -1,8 +1,10 @@ # Auto-GPT: An Autonomous GPT-4 Experiment ### ๐Ÿ”ด ๐Ÿ”ด ๐Ÿ”ด Urgent: USE `stable` not `master` ๐Ÿ”ด ๐Ÿ”ด ๐Ÿ”ด -We've improved our workflow. `master` will often be **in a broken state**. -Download the latest `stable` release here: https://github.com/Torantulino/Auto-GPT/releases/latest -This information SUPERCEDES any following information. Takes precedence. Do this not that. + +> This information takes precedence over any other information provided and should be followed accordingly. + +Our workflow has been improved, but please note that `master` branch may often in a **broken** state. +Please download the latest `stable` release from here: https://github.com/Torantulino/Auto-GPT/releases/latest. ![GitHub Repo stars](https://img.shields.io/github/stars/Torantulino/auto-gpt?style=social) [![Twitter Follow](https://img.shields.io/twitter/follow/siggravitas?style=social)](https://twitter.com/SigGravitas) @@ -91,59 +93,65 @@ Optional: To install Auto-GPT, follow these steps: -1. Make sure you have all the **requirements** above, if not, install/get them. +1. Make sure you have all the **requirements** listed above, if not, install/get them -_The following commands should be executed in a CMD, Bash or Powershell window. To do this, go to a folder on your computer, click in the folder path at the top and type CMD, then press enter._ +_To execute the following commands, open a CMD, Bash, or Powershell window by navigating to a folder on your computer and typing `CMD` in the folder path at the top, then press enter._ -2. Clone the repository: - For this step you need Git installed, but you can just download the zip file instead by clicking the button at the top of this page โ˜๏ธ +2. Clone the repository: For this step, you need Git installed. Alternatively, you can download the zip file by clicking the button at the top of this page โ˜๏ธ -``` +```bash git clone https://github.com/Torantulino/Auto-GPT.git ``` -3. Navigate to the project directory: - _(Type this into your CMD window, you're aiming to navigate the CMD window to the repository you just downloaded)_ +3. Navigate to the directory where the repository was downloaded -``` -cd 'Auto-GPT' +```bash +cd Auto-GPT ``` -4. Install the required dependencies: - _(Again, type this into your CMD window)_ +4. Install the required dependencies -``` +```bash pip install -r requirements.txt ``` 5. Rename `.env.template` to `.env` and fill in your `OPENAI_API_KEY`. If you plan to use Speech Mode, fill in your `ELEVEN_LABS_API_KEY` as well. - See [OpenAI API Keys Configuration](#openai-api-keys-configuration) to obtain your OpenAI API key. - Obtain your ElevenLabs API key from: https://elevenlabs.io. You can view your xi-api-key using the "Profile" tab on the website. - - If you want to use GPT on an Azure instance, set `USE_AZURE` to `True` and then: - - Rename `azure.yaml.template` to `azure.yaml` and provide the relevant `azure_api_base`, `azure_api_version` and all of the deployment ids for the relevant models in the `azure_model_map` section: - - `fast_llm_model_deployment_id` - your gpt-3.5-turbo or gpt-4 deployment id - - `smart_llm_model_deployment_id` - your gpt-4 deployment id - - `embedding_model_deployment_id` - your text-embedding-ada-002 v2 deployment id - - Please specify all of these values as double quoted strings - - details can be found here: https://pypi.org/project/openai/ in the `Microsoft Azure Endpoints` section and here: https://learn.microsoft.com/en-us/azure/cognitive-services/openai/tutorials/embeddings?tabs=command-line for the embedding model. + - If you want to use GPT on an Azure instance, set `USE_AZURE` to `True` and then follow these steps: + - Rename `azure.yaml.template` to `azure.yaml` and provide the relevant `azure_api_base`, `azure_api_version` and all the deployment IDs for the relevant models in the `azure_model_map` section: + - `fast_llm_model_deployment_id` - your gpt-3.5-turbo or gpt-4 deployment ID + - `smart_llm_model_deployment_id` - your gpt-4 deployment ID + - `embedding_model_deployment_id` - your text-embedding-ada-002 v2 deployment ID + - Please specify all of these values as double-quoted strings + > Replace string in angled brackets (<>) to your own ID + ```yaml + azure_model_map: + fast_llm_model_deployment_id: "" + ... + ``` + - Details can be found here: https://pypi.org/project/openai/ in the `Microsoft Azure Endpoints` section and here: https://learn.microsoft.com/en-us/azure/cognitive-services/openai/tutorials/embeddings?tabs=command-line for the embedding model. ## ๐Ÿ”ง Usage -1. Run the `autogpt` Python module in your terminal: - _(Type this into your CMD window)_ +1. Run `autogpt` Python module in your terminal ``` python -m autogpt ``` -2. After each of action, enter 'y' to authorise command, 'y -N' to run N continuous commands, 'n' to exit program, or enter additional feedback for the AI. +2. After each action, choose from options to authorize command(s), +exit the program, or provide feedback to the AI. + 1. Authorize a single command, enter `y` + 2. Authorize a series of _N_ continuous commands, enter `y -N` + 3. Exit the program, enter `n` ### Logs -You will find activity and error logs in the folder `./output/logs` +Activity and error logs are located in the `./output/logs` -To output debug logs: +To print out debug logs: ``` python -m autogpt --debug @@ -165,17 +173,26 @@ docker run -it --env-file=./.env -v $PWD/auto_gpt_workspace:/app/auto_gpt_worksp ### Command Line Arguments Here are some common arguments you can use when running Auto-GPT: > Replace anything in angled brackets (<>) to a value you want to specify -* `python scripts/main.py --help` to see a list of all available command line arguments. -* `python scripts/main.py --ai-settings ` to run Auto-GPT with a different AI Settings file. -* `python scripts/main.py --use-memory ` to specify one of 3 memory backends: `local`, `redis`, `pinecone` or 'no_memory'. +* View all available command line arguments +```bash +python scripts/main.py --help +``` +* Run Auto-GPT with a different AI Settings file +```bash +python scripts/main.py --ai-settings +``` +* Specify one of 3 memory backends: `local`, `redis`, `pinecone` or `no_memory` +```bash +python scripts/main.py --use-memory +``` > **NOTE**: There are shorthands for some of these flags, for example `-m` for `--use-memory`. Use `python scripts/main.py --help` for more information ## ๐Ÿ—ฃ๏ธ Speech Mode -Use this to use TTS for Auto-GPT +Use this to use TTS _(Text-to-Speech)_ for Auto-GPT -``` +```bash python -m autogpt --speak ``` @@ -212,59 +229,47 @@ _Remember that your free daily custom search quota allows only up to 100 searche For Windows Users: -``` +```bash setx GOOGLE_API_KEY "YOUR_GOOGLE_API_KEY" setx CUSTOM_SEARCH_ENGINE_ID "YOUR_CUSTOM_SEARCH_ENGINE_ID" - ``` For macOS and Linux users: -``` +```bash export GOOGLE_API_KEY="YOUR_GOOGLE_API_KEY" export CUSTOM_SEARCH_ENGINE_ID="YOUR_CUSTOM_SEARCH_ENGINE_ID" - ``` -## Memory Backend Setup - -Setup any one backend to persist memory. - -### Redis Setup - -Install docker desktop. - -Run: - -``` +## Redis Setup +> _**CAUTION**_ \ +This is not intended to be publicly accessible and lacks security measures. Therefore, avoid exposing Redis to the internet without a password or at all +1. Install docker desktop +```bash docker run -d --name redis-stack-server -p 6379:6379 redis/redis-stack-server:latest ``` +> See https://hub.docker.com/r/redis/redis-stack-server for setting a password and additional configuration. -See https://hub.docker.com/r/redis/redis-stack-server for setting a password and additional configuration. - -Set the following environment variables: - -``` +2. Set the following environment variables +> Replace **PASSWORD** in angled brackets (<>) +```bash MEMORY_BACKEND=redis REDIS_HOST=localhost REDIS_PORT=6379 -REDIS_PASSWORD= +REDIS_PASSWORD= ``` - -Note that this is not intended to be run facing the internet and is not secure, do not expose redis to the internet without a password or at all really. - You can optionally set -``` +```bash WIPE_REDIS_ON_START=False ``` -To persist memory stored in Redis. +To persist memory stored in Redis You can specify the memory index for redis using the following: -``` -MEMORY_INDEX=whatever +```bash +MEMORY_INDEX= ``` ### ๐ŸŒฒ Pinecone API Key Setup @@ -291,30 +296,30 @@ Pinecone enables the storage of vast amounts of vector-based memory, allowing fo In the `.env` file set: - `PINECONE_API_KEY` -- `PINECONE_ENV` (something like: us-east4-gcp) +- `PINECONE_ENV` (example: _"us-east4-gcp"_) - `MEMORY_BACKEND=pinecone` Alternatively, you can set them from the command line (advanced): For Windows Users: -``` -setx PINECONE_API_KEY "YOUR_PINECONE_API_KEY" -setx PINECONE_ENV "Your pinecone region" # something like: us-east4-gcp +```bash +setx PINECONE_API_KEY "" +setx PINECONE_ENV "" # e.g: "us-east4-gcp" setx MEMORY_BACKEND "pinecone" ``` For macOS and Linux users: -``` -export PINECONE_API_KEY="YOUR_PINECONE_API_KEY" -export PINECONE_ENV="Your pinecone region" # something like: us-east4-gcp +```bash +export PINECONE_API_KEY="" +export PINECONE_ENV="" # e.g: "us-east4-gcp" export MEMORY_BACKEND="pinecone" ``` ## Setting Your Cache Type -By default Auto-GPT is going to use LocalCache instead of redis or Pinecone. +By default, Auto-GPT is going to use LocalCache instead of redis or Pinecone. To switch to either, change the `MEMORY_BACKEND` env variable to the value that you want: @@ -329,7 +334,7 @@ To switch to either, change the `MEMORY_BACKEND` env variable to the value that ## ๐Ÿง  Memory pre-seeding -``` +```bash # python scripts/data_ingestion.py -h usage: data_ingestion.py [-h] (--file FILE | --dir DIR) [--init] [--overlap OVERLAP] [--max_length MAX_LENGTH] @@ -346,7 +351,7 @@ options: # python scripts/data_ingestion.py --dir seed_data --init --overlap 200 --max_length 1000 ``` -This script located at scripts/data_ingestion.py, allows you to ingest files into memory and pre-seed it before running Auto-GPT. +This script located at `scripts/data_ingestion.py`, allows you to ingest files into memory and pre-seed it before running Auto-GPT. Memory pre-seeding is a technique that involves ingesting relevant documents or data into the AI's memory so that it can use this information to generate more informed and accurate responses. @@ -355,35 +360,34 @@ To pre-seed the memory, the content of each document is split into chunks of a s This technique is particularly useful when working with large amounts of data or when there is specific information that the AI needs to be able to access quickly. By pre-seeding the memory, the AI can retrieve and use this information more efficiently, saving time, API call and improving the accuracy of its responses. -You could for example download the documentation of an API, a Github repository, etc. and ingest it into memory before running Auto-GPT. +You could for example download the documentation of an API, a GitHub repository, etc. and ingest it into memory before running Auto-GPT. -โš ๏ธ If you use Redis as your memory, make sure to run Auto-GPT with the WIPE_REDIS_ON_START set to False in your .env file. +โš ๏ธ If you use Redis as your memory, make sure to run Auto-GPT with the `WIPE_REDIS_ON_START` set to `False` in your `.env` file. -โš ๏ธFor other memory backend, we currently forcefully wipe the memory when starting Auto-GPT. To ingest data with those memory backend, you can call the data_ingestion.py script anytime during an Auto-GPT run. +โš ๏ธFor other memory backend, we currently forcefully wipe the memory when starting Auto-GPT. To ingest data with those memory backend, you can call the `data_ingestion.py` script anytime during an Auto-GPT run. Memories will be available to the AI immediately as they are ingested, even if ingested while Auto-GPT is running. -In the example above, the script initializes the memory, ingests all files within the seed_data directory into memory with an overlap between chunks of 200 and a maximum length of each chunk of 4000. -Note that you can also use the --file argument to ingest a single file into memory and that the script will only ingest files within the auto_gpt_workspace directory. +In the example above, the script initializes the memory, ingests all files within the `/seed_data` directory into memory with an overlap between chunks of 200 and a maximum length of each chunk of 4000. +Note that you can also use the `--file` argument to ingest a single file into memory and that the script will only ingest files within the `/auto_gpt_workspace` directory. -You can adjust the max_length and overlap parameters to fine-tune the way the documents are presented to the AI when it "recall" that memory: +You can adjust the `max_length` and overlap parameters to fine-tune the way the docuents are presented to the AI when it "recall" that memory: - Adjusting the overlap value allows the AI to access more contextual information from each chunk when recalling information, but will result in more chunks being created and therefore increase memory backend usage and OpenAI API requests. -- Reducing the max_length value will create more chunks, which can save prompt tokens by allowing for more message history in the context, but will also increase the number of chunks. -- Increasing the max_length value will provide the AI with more contextual information from each chunk, reducing the number of chunks created and saving on OpenAI API requests. However, this may also use more prompt tokens and decrease the overall context available to the AI. +- Reducing the `max_length` value will create more chunks, which can save prompt tokens by allowing for more message history in the context, but will also increase the number of chunks. +- Increasing the `max_length` value will provide the AI with more contextual information from each chunk, reducing the number of chunks created and saving on OpenAI API requests. However, this may also use more prompt tokens and decrease the overall context available to the AI. ## ๐Ÿ’€ Continuous Mode โš ๏ธ -Run the AI **without** user authorisation, 100% automated. -Continuous mode is not recommended. -It is potentially dangerous and may cause your AI to run forever or carry out actions you would not usually authorise. +Run the AI **without** user authorization, 100% automated. +Continuous mode is NOT recommended. +It is potentially dangerous and may cause your AI to run forever or carry out actions you would not usually authorize. Use at your own risk. 1. Run the `autogpt` python module in your terminal: -``` +```bash python -m autogpt --speak --continuous - ``` 2. To exit the program, press Ctrl + C @@ -392,7 +396,7 @@ python -m autogpt --speak --continuous If you don't have access to the GPT4 api, this mode will allow you to use Auto-GPT! -``` +```bash python -m autogpt --speak --gpt3only ``` @@ -404,15 +408,16 @@ By default, Auto-GPT uses DALL-e for image generation. To use Stable Diffusion, Once you have a token, set these variables in your `.env`: -``` +```bash IMAGE_PROVIDER=sd HUGGINGFACE_API_TOKEN="YOUR_HUGGINGFACE_API_TOKEN" ``` ## Selenium +```bash +sudo Xvfb :10 -ac -screen 0 1024x768x24 & DISPLAY=:10 +``` -sudo Xvfb :10 -ac -screen 0 1024x768x24 & -DISPLAY=:10 your-client ## โš ๏ธ Limitations This experiment aims to showcase the potential of GPT-4 but comes with some limitations: @@ -453,13 +458,13 @@ We look forward to connecting with you and hearing your thoughts, ideas, and exp To run tests, run the following command: -``` +```bash python -m unittest discover tests ``` To run tests and see coverage, run the following command: -``` +```bash coverage run -m unittest discover tests ``` @@ -469,7 +474,7 @@ This project uses [flake8](https://flake8.pycqa.org/en/latest/) for linting. We To run the linter, run the following command: -``` +```bash flake8 autogpt/ tests/ # Or, if you want to run flake8 with the same configuration as the CI: From c1f18b5324952d13cfe9a085c65236393a8bc804 Mon Sep 17 00:00:00 2001 From: Richard Beales Date: Sat, 15 Apr 2023 19:25:44 +0100 Subject: [PATCH 66/78] Revert "Add ability to use local embeddings model" (#1662) --- .env.template | 2 -- autogpt/config/config.py | 4 +--- autogpt/memory/base.py | 46 +++++++++----------------------------- autogpt/memory/local.py | 8 +++---- autogpt/memory/pinecone.py | 15 ++++++++----- autogpt/memory/redismem.py | 13 +++++------ requirements.txt | 1 - tests/embedder_test.py | 26 --------------------- 8 files changed, 30 insertions(+), 85 deletions(-) delete mode 100644 tests/embedder_test.py diff --git a/.env.template b/.env.template index 6d393e67..ac3d27b0 100644 --- a/.env.template +++ b/.env.template @@ -52,8 +52,6 @@ SMART_TOKEN_LIMIT=8000 # MEMORY_BACKEND - Memory backend type (Default: local) MEMORY_BACKEND=local -# MEMORY_EMBEDDER - Embeddings model to use (Default: ada) -MEMORY_EMBEDDER=ada ### PINECONE # PINECONE_API_KEY - Pinecone API Key (Example: my-pinecone-api-key) diff --git a/autogpt/config/config.py b/autogpt/config/config.py index ed36be69..365bc320 100644 --- a/autogpt/config/config.py +++ b/autogpt/config/config.py @@ -88,9 +88,7 @@ class Config(metaclass=Singleton): self.memory_index = os.getenv("MEMORY_INDEX", "auto-gpt") # Note that indexes must be created on db 0 in redis, this is not configurable. - self.memory_backend = os.getenv("MEMORY_BACKEND", 'local') - self.memory_embedder = os.getenv("MEMORY_EMBEDDER", 'ada') - + self.memory_backend = os.getenv("MEMORY_BACKEND", "local") # Initialize the OpenAI API client openai.api_key = self.openai_api_key diff --git a/autogpt/memory/base.py b/autogpt/memory/base.py index bf703660..691e2299 100644 --- a/autogpt/memory/base.py +++ b/autogpt/memory/base.py @@ -1,50 +1,24 @@ """Base class for memory providers.""" import abc + import openai + from autogpt.config import AbstractSingleton, Config - -# try to import sentence transformers, if it fails, default to ada -try: - from sentence_transformers import SentenceTransformer -except ImportError: - SentenceTransformer = None - if cfg.memory_embedder == "sbert": - print("Error: Sentence Transformers is not installed. Please install sentence_transformers" - " to use sBERT as an embedder. Defaulting to Ada.") - cfg.memory_embedder = "ada" - - cfg = Config() -# Dimension of embeddings encoded by embedders -EMBED_DIM = { - "ada": 1536, - "sbert": 768 -}.get(cfg.memory_embedder, 1536) -def get_embedding(text): +def get_ada_embedding(text): text = text.replace("\n", " ") - - # Use the embedder specified in the config - if cfg.memory_embedder == "sbert": - # sBERT model - embedding = SentenceTransformer("sentence-transformers/all-mpnet-base-v2", device="cpu").encode(text, show_progress_bar=False) - else: - # Ada model - model = "text-embedding-ada-002" - engine = None - if cfg.use_azure: - engine = cfg.get_azure_deployment_id_for_model(model) - model = None - - embedding = openai.Embedding.create( + if cfg.use_azure: + return openai.Embedding.create( input=[text], - model=model, - engine=engine, + engine=cfg.get_azure_deployment_id_for_model("text-embedding-ada-002"), )["data"][0]["embedding"] - - return embedding + else: + return openai.Embedding.create(input=[text], model="text-embedding-ada-002")[ + "data" + ][0]["embedding"] class MemoryProviderSingleton(AbstractSingleton): diff --git a/autogpt/memory/local.py b/autogpt/memory/local.py index 28ddfeb8..a5f6076e 100644 --- a/autogpt/memory/local.py +++ b/autogpt/memory/local.py @@ -5,9 +5,9 @@ from typing import Any, List, Optional, Tuple import numpy as np import orjson -from autogpt.memory.base import MemoryProviderSingleton, get_embedding, EMBED_DIM - +from autogpt.memory.base import MemoryProviderSingleton, get_ada_embedding +EMBED_DIM = 1536 SAVE_OPTIONS = orjson.OPT_SERIALIZE_NUMPY | orjson.OPT_SERIALIZE_DATACLASS @@ -70,7 +70,7 @@ class LocalCache(MemoryProviderSingleton): return "" self.data.texts.append(text) - embedding = get_embedding(text) + embedding = get_ada_embedding(text) vector = np.array(embedding).astype(np.float32) vector = vector[np.newaxis, :] @@ -118,7 +118,7 @@ class LocalCache(MemoryProviderSingleton): Returns: List[str] """ - embedding = get_embedding(text) + embedding = get_ada_embedding(text) scores = np.dot(self.data.embeddings, embedding) diff --git a/autogpt/memory/pinecone.py b/autogpt/memory/pinecone.py index e95fe4d4..a7dbfa82 100644 --- a/autogpt/memory/pinecone.py +++ b/autogpt/memory/pinecone.py @@ -2,7 +2,7 @@ import pinecone from colorama import Fore, Style from autogpt.logs import logger -from autogpt.memory.base import MemoryProviderSingleton, get_embedding, EMBED_DIM +from autogpt.memory.base import MemoryProviderSingleton, get_ada_embedding class PineconeMemory(MemoryProviderSingleton): @@ -10,6 +10,7 @@ class PineconeMemory(MemoryProviderSingleton): pinecone_api_key = cfg.pinecone_api_key pinecone_region = cfg.pinecone_region pinecone.init(api_key=pinecone_api_key, environment=pinecone_region) + dimension = 1536 metric = "cosine" pod_type = "p1" table_name = "auto-gpt" @@ -36,11 +37,13 @@ class PineconeMemory(MemoryProviderSingleton): exit(1) if table_name not in pinecone.list_indexes(): - pinecone.create_index(table_name, dimension=EMBED_DIM, metric=metric, pod_type=pod_type) + pinecone.create_index( + table_name, dimension=dimension, metric=metric, pod_type=pod_type + ) self.index = pinecone.Index(table_name) def add(self, data): - vector = get_embedding(data) + vector = get_ada_embedding(data) # no metadata here. We may wish to change that long term. self.index.upsert([(str(self.vec_num), vector, {"raw_text": data})]) _text = f"Inserting data into memory at index: {self.vec_num}:\n data: {data}" @@ -60,8 +63,10 @@ class PineconeMemory(MemoryProviderSingleton): :param data: The data to compare to. :param num_relevant: The number of relevant data to return. Defaults to 5 """ - query_embedding = get_embedding(data) - results = self.index.query(query_embedding, top_k=num_relevant, include_metadata=True) + query_embedding = get_ada_embedding(data) + results = self.index.query( + query_embedding, top_k=num_relevant, include_metadata=True + ) sorted_results = sorted(results.matches, key=lambda x: x.score) return [str(item["metadata"]["raw_text"]) for item in sorted_results] diff --git a/autogpt/memory/redismem.py b/autogpt/memory/redismem.py index 541923b8..df6d8fc0 100644 --- a/autogpt/memory/redismem.py +++ b/autogpt/memory/redismem.py @@ -9,18 +9,14 @@ from redis.commands.search.indexDefinition import IndexDefinition, IndexType from redis.commands.search.query import Query from autogpt.logs import logger -from autogpt.memory.base import MemoryProviderSingleton, get_embedding, EMBED_DIM +from autogpt.memory.base import MemoryProviderSingleton, get_ada_embedding SCHEMA = [ TextField("data"), VectorField( "embedding", "HNSW", - { - "TYPE": "FLOAT32", - "DIM": EMBED_DIM, - "DISTANCE_METRIC": "COSINE" - } + {"TYPE": "FLOAT32", "DIM": 1536, "DISTANCE_METRIC": "COSINE"}, ), ] @@ -38,6 +34,7 @@ class RedisMemory(MemoryProviderSingleton): redis_host = cfg.redis_host redis_port = cfg.redis_port redis_password = cfg.redis_password + self.dimension = 1536 self.redis = redis.Redis( host=redis_host, port=redis_port, @@ -88,7 +85,7 @@ class RedisMemory(MemoryProviderSingleton): """ if "Command Error:" in data: return "" - vector = get_embedding(data) + vector = get_ada_embedding(data) vector = np.array(vector).astype(np.float32).tobytes() data_dict = {b"data": data, "embedding": vector} pipe = self.redis.pipeline() @@ -130,7 +127,7 @@ class RedisMemory(MemoryProviderSingleton): Returns: A list of the most relevant data. """ - query_embedding = get_embedding(data) + query_embedding = get_ada_embedding(data) base_query = f"*=>[KNN {num_relevant} @embedding $vector AS vector_score]" query = ( Query(base_query) diff --git a/requirements.txt b/requirements.txt index 5ea6dcf8..ab1920c0 100644 --- a/requirements.txt +++ b/requirements.txt @@ -20,7 +20,6 @@ selenium webdriver-manager coverage flake8 -sentence_transformers numpy pre-commit black diff --git a/tests/embedder_test.py b/tests/embedder_test.py deleted file mode 100644 index 5b9ca798..00000000 --- a/tests/embedder_test.py +++ /dev/null @@ -1,26 +0,0 @@ -import os -import sys - -from autogpt.config import Config -from autogpt.memory.base import get_embedding - -# Required, because the get_embedding function uses it -cfg = Config() - - -class TestMemoryEmbedder(unittest.TestCase): - def test_ada(self): - cfg.memory_embedder = "ada" - text = "Sample text" - result = get_embedding(text) - self.assertEqual(len(result), 1536) - - def test_sbert(self): - cfg.memory_embedder = "sbert" - text = "Sample text" - result = get_embedding(text) - self.assertEqual(len(result), 768) - - -if __name__ == '__main__': - unittest.main() From c8c4e2b59c17f444db3e806593b507450f0e61e1 Mon Sep 17 00:00:00 2001 From: Richard Beales Date: Sat, 15 Apr 2023 18:56:04 +0100 Subject: [PATCH 67/78] Fix invalid config import in git_operations --- autogpt/commands/git_operations.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/autogpt/commands/git_operations.py b/autogpt/commands/git_operations.py index 87232589..51336052 100644 --- a/autogpt/commands/git_operations.py +++ b/autogpt/commands/git_operations.py @@ -1,5 +1,5 @@ import git -from config import Config +from autogpt.config import Config cfg = Config() From 35192cf41386a7fbc3baf1e844282c922fdfd794 Mon Sep 17 00:00:00 2001 From: Pi Date: Sat, 15 Apr 2023 19:47:04 +0100 Subject: [PATCH 68/78] Update requirements.txt --- requirements.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/requirements.txt b/requirements.txt index ab1920c0..23627f3e 100644 --- a/requirements.txt +++ b/requirements.txt @@ -12,7 +12,7 @@ docker duckduckgo-search google-api-python-client #(https://developers.google.com/custom-search/v1/overview) pinecone-client==2.2.1 -pymilvus==2.2.4 +# pymilvus==2.2.4 # Uncomment to use, but don't push uncommented to repo (causes trouble with package-installation in automated tests) redis orjson Pillow From a1d201028bd2308ad3549c678f11ae2b91765660 Mon Sep 17 00:00:00 2001 From: Pi Date: Sat, 15 Apr 2023 19:51:52 +0100 Subject: [PATCH 69/78] Added missing \n at end of file --- tests/milvus_memory_test.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tests/milvus_memory_test.py b/tests/milvus_memory_test.py index c64924f7..7e3f185a 100644 --- a/tests/milvus_memory_test.py +++ b/tests/milvus_memory_test.py @@ -61,4 +61,4 @@ class TestMilvusMemory(unittest.TestCase): if __name__ == "__main__": - unittest.main() \ No newline at end of file + unittest.main() From 77f44cdbbecb7ccc959685650977245daa1545ca Mon Sep 17 00:00:00 2001 From: nponeccop Date: Sat, 15 Apr 2023 20:59:38 +0200 Subject: [PATCH 70/78] Fix run.bat to use the new module --- run.bat | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/run.bat b/run.bat index 081af67c..afbab57a 100644 --- a/run.bat +++ b/run.bat @@ -4,5 +4,5 @@ if errorlevel 1 ( echo Installing missing packages... pip install -r requirements.txt ) -python scripts/main.py %1 +python -m autogpt %* pause From 051b5372cec13b6f9031e0f678fc8fd5eaf60ac2 Mon Sep 17 00:00:00 2001 From: hyaxia Date: Sat, 15 Apr 2023 22:06:27 +0300 Subject: [PATCH 71/78] in debug mode add a log about rate limit error --- autogpt/llm_utils.py | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/autogpt/llm_utils.py b/autogpt/llm_utils.py index f2418b65..aafa84b3 100644 --- a/autogpt/llm_utils.py +++ b/autogpt/llm_utils.py @@ -95,6 +95,11 @@ def create_chat_completion( ) break except RateLimitError: + if CFG.debug_mode: + print( + Fore.RED + "Error: ", + f"Reached rate limit. Waiting {backoff} seconds..." + Fore.RESET, + ) pass except APIError as e: if e.http_status == 502: From 27a21e848d174d4599ebe6a863f9159a93e53985 Mon Sep 17 00:00:00 2001 From: Luca Meneghetti <100935601+thisislvca@users.noreply.github.com> Date: Sat, 15 Apr 2023 21:07:27 +0200 Subject: [PATCH 72/78] Update README.md Fixed a typo in the README.md file: From "may often in a **broken** state." to "may often be in a **broken** state." --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index cf370f13..ae487ceb 100644 --- a/README.md +++ b/README.md @@ -3,7 +3,7 @@ > This information takes precedence over any other information provided and should be followed accordingly. -Our workflow has been improved, but please note that `master` branch may often in a **broken** state. +Our workflow has been improved, but please note that `master` branch may often be in a **broken** state. Please download the latest `stable` release from here: https://github.com/Torantulino/Auto-GPT/releases/latest. ![GitHub Repo stars](https://img.shields.io/github/stars/Torantulino/auto-gpt?style=social) From 2f776957d8832eb2aa78c92d643266529b7685d7 Mon Sep 17 00:00:00 2001 From: hyaxia Date: Sat, 15 Apr 2023 22:20:05 +0300 Subject: [PATCH 73/78] changed error msg --- autogpt/llm_utils.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/autogpt/llm_utils.py b/autogpt/llm_utils.py index aafa84b3..4e74566b 100644 --- a/autogpt/llm_utils.py +++ b/autogpt/llm_utils.py @@ -98,7 +98,7 @@ def create_chat_completion( if CFG.debug_mode: print( Fore.RED + "Error: ", - f"Reached rate limit. Waiting {backoff} seconds..." + Fore.RESET, + f"Reached rate limit, passing..." + Fore.RESET, ) pass except APIError as e: From bebc015eb3ea1cf5cfea83dfef1e60324d747445 Mon Sep 17 00:00:00 2001 From: DJ Stomp <85457381+DJStompZone@users.noreply.github.com> Date: Sat, 15 Apr 2023 12:30:09 -0700 Subject: [PATCH 74/78] Update requirements.txt --- requirements.txt | 1 - 1 file changed, 1 deletion(-) diff --git a/requirements.txt b/requirements.txt index 23627f3e..dbfa7741 100644 --- a/requirements.txt +++ b/requirements.txt @@ -12,7 +12,6 @@ docker duckduckgo-search google-api-python-client #(https://developers.google.com/custom-search/v1/overview) pinecone-client==2.2.1 -# pymilvus==2.2.4 # Uncomment to use, but don't push uncommented to repo (causes trouble with package-installation in automated tests) redis orjson Pillow From 11d6dabe37f831d775c2a3d18b83c92069ea0640 Mon Sep 17 00:00:00 2001 From: BillSchumacher <34168009+BillSchumacher@users.noreply.github.com> Date: Sat, 15 Apr 2023 14:55:13 -0500 Subject: [PATCH 75/78] Quality update --- autogpt/__main__.py | 4 +- autogpt/app.py | 20 +++++--- autogpt/args.py | 2 +- autogpt/commands/execute_code.py | 4 +- autogpt/commands/git_operations.py | 20 +++++--- autogpt/commands/web_selenium.py | 6 ++- autogpt/config/config.py | 4 +- autogpt/json_fixes/auto_fix.py | 15 ++++-- autogpt/memory/__init__.py | 15 ++++-- autogpt/memory/milvus.py | 81 +++++++++++++++++++----------- autogpt/prompt.py | 6 ++- scripts/check_requirements.py | 18 ++++--- tests/milvus_memory_test.py | 1 - tests/smoke_test.py | 39 +++++++------- tests/test_token_counter.py | 17 ++++--- 15 files changed, 161 insertions(+), 91 deletions(-) diff --git a/autogpt/__main__.py b/autogpt/__main__.py index 5105df55..29ccddbf 100644 --- a/autogpt/__main__.py +++ b/autogpt/__main__.py @@ -34,7 +34,9 @@ def main() -> None: # Initialize memory and make sure it is empty. # this is particularly important for indexing and referencing pinecone memory memory = get_memory(cfg, init=True) - logger.typewriter_log(f"Using memory of type:", Fore.GREEN, f"{memory.__class__.__name__}") + logger.typewriter_log( + f"Using memory of type:", Fore.GREEN, f"{memory.__class__.__name__}" + ) logger.typewriter_log(f"Using Browser:", Fore.GREEN, cfg.selenium_web_browser) agent = Agent( ai_name=ai_name, diff --git a/autogpt/app.py b/autogpt/app.py index eb585134..e84241c5 100644 --- a/autogpt/app.py +++ b/autogpt/app.py @@ -89,13 +89,13 @@ def get_command(response: str): def map_command_synonyms(command_name: str): - """ Takes the original command name given by the AI, and checks if the - string matches a list of common/known hallucinations + """Takes the original command name given by the AI, and checks if the + string matches a list of common/known hallucinations """ synonyms = [ - ('write_file', 'write_to_file'), - ('create_file', 'write_to_file'), - ('search', 'google') + ("write_file", "write_to_file"), + ("create_file", "write_to_file"), + ("search", "google"), ] for seen_command, actual_command_name in synonyms: if command_name == seen_command: @@ -125,7 +125,7 @@ def execute_command(command_name: str, arguments): google_result = google_official_search(arguments["input"]) else: google_result = google_search(arguments["input"]) - safe_message = google_result.encode('utf-8', 'ignore') + safe_message = google_result.encode("utf-8", "ignore") return str(safe_message) elif command_name == "memory_add": return memory.add(arguments["string"]) @@ -144,7 +144,9 @@ def execute_command(command_name: str, arguments): elif command_name == "get_hyperlinks": return get_hyperlinks(arguments["url"]) elif command_name == "clone_repository": - return clone_repository(arguments["repository_url"], arguments["clone_path"]) + return clone_repository( + arguments["repository_url"], arguments["clone_path"] + ) elif command_name == "read_file": return read_file(arguments["file"]) elif command_name == "write_to_file": @@ -278,7 +280,9 @@ def list_agents(): Returns: str: A list of all agents """ - return "List of agents:\n" + "\n".join([str(x[0]) + ": " + x[1] for x in AGENT_MANAGER.list_agents()]) + return "List of agents:\n" + "\n".join( + [str(x[0]) + ": " + x[1] for x in AGENT_MANAGER.list_agents()] + ) def delete_agent(key: str) -> str: diff --git a/autogpt/args.py b/autogpt/args.py index 0bc3e680..eca32334 100644 --- a/autogpt/args.py +++ b/autogpt/args.py @@ -54,7 +54,7 @@ def parse_arguments() -> None: "--use-browser", "-b", dest="browser_name", - help="Specifies which web-browser to use when using selenium to scrape the web." + help="Specifies which web-browser to use when using selenium to scrape the web.", ) parser.add_argument( "--ai-settings", diff --git a/autogpt/commands/execute_code.py b/autogpt/commands/execute_code.py index 93f3532e..86d6c177 100644 --- a/autogpt/commands/execute_code.py +++ b/autogpt/commands/execute_code.py @@ -99,8 +99,8 @@ def execute_shell(command_line: str) -> str: str: The output of the command """ current_dir = os.getcwd() - - if str(WORKING_DIRECTORY) not in current_dir: # Change dir into workspace if necessary + # Change dir into workspace if necessary + if str(WORKING_DIRECTORY) not in current_dir: work_dir = os.path.join(os.getcwd(), WORKING_DIRECTORY) os.chdir(work_dir) diff --git a/autogpt/commands/git_operations.py b/autogpt/commands/git_operations.py index 51336052..3483474b 100644 --- a/autogpt/commands/git_operations.py +++ b/autogpt/commands/git_operations.py @@ -1,14 +1,20 @@ +"""Git operations for autogpt""" import git from autogpt.config import Config -cfg = Config() +CFG = Config() -def clone_repository(repo_url, clone_path): - """Clone a github repository locally""" +def clone_repository(repo_url: str, clone_path: str) -> str: + """Clone a github repository locally + + Args: + repo_url (str): The URL of the repository to clone + clone_path (str): The path to clone the repository to + + Returns: + str: The result of the clone operation""" split_url = repo_url.split("//") - auth_repo_url = f"//{cfg.github_username}:{cfg.github_api_key}@".join(split_url) + auth_repo_url = f"//{CFG.github_username}:{CFG.github_api_key}@".join(split_url) git.Repo.clone_from(auth_repo_url, clone_path) - result = f"""Cloned {repo_url} to {clone_path}""" - - return result + return f"""Cloned {repo_url} to {clone_path}""" diff --git a/autogpt/commands/web_selenium.py b/autogpt/commands/web_selenium.py index ddcb3155..d2ef1a7e 100644 --- a/autogpt/commands/web_selenium.py +++ b/autogpt/commands/web_selenium.py @@ -53,7 +53,11 @@ def scrape_text_with_selenium(url: str) -> Tuple[WebDriver, str]: """ logging.getLogger("selenium").setLevel(logging.CRITICAL) - options_available = {'chrome': ChromeOptions, 'safari': SafariOptions, 'firefox': FirefoxOptions} + options_available = { + "chrome": ChromeOptions, + "safari": SafariOptions, + "firefox": FirefoxOptions, + } options = options_available[CFG.selenium_web_browser]() options.add_argument( diff --git a/autogpt/config/config.py b/autogpt/config/config.py index 365bc320..c47b19af 100644 --- a/autogpt/config/config.py +++ b/autogpt/config/config.py @@ -137,7 +137,9 @@ class Config(metaclass=Singleton): config_params = {} self.openai_api_type = config_params.get("azure_api_type") or "azure" self.openai_api_base = config_params.get("azure_api_base") or "" - self.openai_api_version = config_params.get("azure_api_version") or "2023-03-15-preview" + self.openai_api_version = ( + config_params.get("azure_api_version") or "2023-03-15-preview" + ) self.azure_model_to_deployment_id_map = config_params.get("azure_model_map", []) def set_continuous_mode(self, value: bool) -> None: diff --git a/autogpt/json_fixes/auto_fix.py b/autogpt/json_fixes/auto_fix.py index ac648460..56664ba9 100644 --- a/autogpt/json_fixes/auto_fix.py +++ b/autogpt/json_fixes/auto_fix.py @@ -4,11 +4,20 @@ import json from autogpt.llm_utils import call_ai_function from autogpt.logs import logger from autogpt.config import Config -cfg = Config() + +CFG = Config() def fix_json(json_string: str, schema: str) -> str: - """Fix the given JSON string to make it parseable and fully compliant with the provided schema.""" + """Fix the given JSON string to make it parseable and fully compliant with + the provided schema. + + Args: + json_string (str): The JSON string to fix. + schema (str): The schema to use to fix the JSON. + Returns: + str: The fixed JSON string. + """ # Try to fix the JSON using GPT: function_string = "def fix_json(json_string: str, schema:str=None) -> str:" args = [f"'''{json_string}'''", f"'''{schema}'''"] @@ -24,7 +33,7 @@ def fix_json(json_string: str, schema: str) -> str: if not json_string.startswith("`"): json_string = "```json\n" + json_string + "\n```" result_string = call_ai_function( - function_string, args, description_string, model=cfg.fast_llm_model + function_string, args, description_string, model=CFG.fast_llm_model ) logger.debug("------------ JSON FIX ATTEMPT ---------------") logger.debug(f"Original JSON: {json_string}") diff --git a/autogpt/memory/__init__.py b/autogpt/memory/__init__.py index 102b93ae..ab953527 100644 --- a/autogpt/memory/__init__.py +++ b/autogpt/memory/__init__.py @@ -50,8 +50,10 @@ def get_memory(cfg, init=False): memory = RedisMemory(cfg) elif cfg.memory_backend == "milvus": if not MilvusMemory: - print("Error: Milvus sdk is not installed." - "Please install pymilvus to use Milvus as memory backend.") + print( + "Error: Milvus sdk is not installed." + "Please install pymilvus to use Milvus as memory backend." + ) else: memory = MilvusMemory(cfg) elif cfg.memory_backend == "no_memory": @@ -68,4 +70,11 @@ def get_supported_memory_backends(): return supported_memory -__all__ = ["get_memory", "LocalCache", "RedisMemory", "PineconeMemory", "NoMemory", "MilvusMemory"] +__all__ = [ + "get_memory", + "LocalCache", + "RedisMemory", + "PineconeMemory", + "NoMemory", + "MilvusMemory", +] diff --git a/autogpt/memory/milvus.py b/autogpt/memory/milvus.py index fce46a89..c6e7d5a3 100644 --- a/autogpt/memory/milvus.py +++ b/autogpt/memory/milvus.py @@ -1,3 +1,4 @@ +""" Milvus memory storage provider.""" from pymilvus import ( connections, FieldSchema, @@ -10,8 +11,10 @@ from autogpt.memory.base import MemoryProviderSingleton, get_ada_embedding class MilvusMemory(MemoryProviderSingleton): - def __init__(self, cfg): - """ Construct a milvus memory storage connection. + """Milvus memory storage provider.""" + + def __init__(self, cfg) -> None: + """Construct a milvus memory storage connection. Args: cfg (Config): Auto-GPT global config. @@ -19,12 +22,9 @@ class MilvusMemory(MemoryProviderSingleton): # connect to milvus server. connections.connect(address=cfg.milvus_addr) fields = [ - FieldSchema(name="pk", dtype=DataType.INT64, - is_primary=True, auto_id=True), - FieldSchema(name="embeddings", - dtype=DataType.FLOAT_VECTOR, dim=1536), - FieldSchema(name="raw_text", dtype=DataType.VARCHAR, - max_length=65535) + FieldSchema(name="pk", dtype=DataType.INT64, is_primary=True, auto_id=True), + FieldSchema(name="embeddings", dtype=DataType.FLOAT_VECTOR, dim=1536), + FieldSchema(name="raw_text", dtype=DataType.VARCHAR, max_length=65535), ] # create collection if not exist and load it. @@ -34,15 +34,19 @@ class MilvusMemory(MemoryProviderSingleton): # create index if not exist. if not self.collection.has_index(): self.collection.release() - self.collection.create_index("embeddings", { - "metric_type": "IP", - "index_type": "HNSW", - "params": {"M": 8, "efConstruction": 64}, - }, index_name="embeddings") + self.collection.create_index( + "embeddings", + { + "metric_type": "IP", + "index_type": "HNSW", + "params": {"M": 8, "efConstruction": 64}, + }, + index_name="embeddings", + ) self.collection.load() - def add(self, data): - """ Add a embedding of data into memory. + def add(self, data) -> str: + """Add a embedding of data into memory. Args: data (str): The raw text to construct embedding index. @@ -52,34 +56,48 @@ class MilvusMemory(MemoryProviderSingleton): """ embedding = get_ada_embedding(data) result = self.collection.insert([[embedding], [data]]) - _text = f"Inserting data into memory at primary key: {result.primary_keys[0]}:\n data: {data}" + _text = ( + "Inserting data into memory at primary key: " + f"{result.primary_keys[0]}:\n data: {data}" + ) return _text def get(self, data): - """ Return the most relevant data in memory. + """Return the most relevant data in memory. Args: data: The data to compare to. """ return self.get_relevant(data, 1) - def clear(self): - """ Drop the index in memory. + def clear(self) -> str: + """Drop the index in memory. + + Returns: + str: log. """ self.collection.drop() self.collection = Collection(self.milvus_collection, self.schema) - self.collection.create_index("embeddings", { - "metric_type": "IP", - "index_type": "HNSW", - "params": {"M": 8, "efConstruction": 64}, - }, index_name="embeddings") + self.collection.create_index( + "embeddings", + { + "metric_type": "IP", + "index_type": "HNSW", + "params": {"M": 8, "efConstruction": 64}, + }, + index_name="embeddings", + ) self.collection.load() return "Obliviated" - def get_relevant(self, data, num_relevant=5): - """ Return the top-k relevant data in memory. + def get_relevant(self, data: str, num_relevant: int = 5): + """Return the top-k relevant data in memory. Args: data: The data to compare to. - num_relevant (int, optional): The max number of relevant data. Defaults to 5. + num_relevant (int, optional): The max number of relevant data. + Defaults to 5. + + Returns: + list: The top-k relevant data. """ # search the embedding and return the most relevant text. embedding = get_ada_embedding(data) @@ -88,10 +106,15 @@ class MilvusMemory(MemoryProviderSingleton): "params": {"nprobe": 8}, } result = self.collection.search( - [embedding], "embeddings", search_params, num_relevant, output_fields=["raw_text"]) + [embedding], + "embeddings", + search_params, + num_relevant, + output_fields=["raw_text"], + ) return [item.entity.value_of_field("raw_text") for item in result[0]] - def get_stats(self): + def get_stats(self) -> str: """ Returns: The stats of the milvus cache. """ diff --git a/autogpt/prompt.py b/autogpt/prompt.py index 5924ce0c..6c51f33e 100644 --- a/autogpt/prompt.py +++ b/autogpt/prompt.py @@ -59,7 +59,11 @@ def get_prompt() -> str: ), ("List GPT Agents", "list_agents", {}), ("Delete GPT Agent", "delete_agent", {"key": ""}), - ("Clone Repository", "clone_repository", {"repository_url": "", "clone_path": ""}), + ( + "Clone Repository", + "clone_repository", + {"repository_url": "", "clone_path": ""}, + ), ("Write to file", "write_to_file", {"file": "", "text": ""}), ("Read file", "read_file", {"file": ""}), ("Append to file", "append_to_file", {"file": "", "text": ""}), diff --git a/scripts/check_requirements.py b/scripts/check_requirements.py index a74ba367..d1f23504 100644 --- a/scripts/check_requirements.py +++ b/scripts/check_requirements.py @@ -1,10 +1,13 @@ import pkg_resources import sys + def main(): requirements_file = sys.argv[1] - with open(requirements_file, 'r') as f: - required_packages = [line.strip().split('#')[0].strip() for line in f.readlines()] + with open(requirements_file, "r") as f: + required_packages = [ + line.strip().split("#")[0].strip() for line in f.readlines() + ] installed_packages = [package.key for package in pkg_resources.working_set] @@ -12,16 +15,17 @@ def main(): for package in required_packages: if not package: # Skip empty lines continue - package_name = package.strip().split('==')[0] + package_name = package.strip().split("==")[0] if package_name.lower() not in installed_packages: missing_packages.append(package_name) if missing_packages: - print('Missing packages:') - print(', '.join(missing_packages)) + print("Missing packages:") + print(", ".join(missing_packages)) sys.exit(1) else: - print('All packages are installed.') + print("All packages are installed.") -if __name__ == '__main__': + +if __name__ == "__main__": main() diff --git a/tests/milvus_memory_test.py b/tests/milvus_memory_test.py index 7e3f185a..0113fa1c 100644 --- a/tests/milvus_memory_test.py +++ b/tests/milvus_memory_test.py @@ -15,7 +15,6 @@ def MockConfig(): "speak_mode": False, "milvus_collection": "autogpt", "milvus_addr": "localhost:19530", - }, ) diff --git a/tests/smoke_test.py b/tests/smoke_test.py index 1f0f24f9..8d33cf89 100644 --- a/tests/smoke_test.py +++ b/tests/smoke_test.py @@ -5,56 +5,59 @@ import unittest from autogpt.file_operations import delete_file, read_file -env_vars = { - 'MEMORY_BACKEND': 'no_memory', - 'TEMPERATURE': "0" -} +env_vars = {"MEMORY_BACKEND": "no_memory", "TEMPERATURE": "0"} class TestCommands(unittest.TestCase): - def test_write_file(self): # Test case to check if the write_file command can successfully write 'Hello World' to a file # named 'hello_world.txt'. # Read the current ai_settings.yaml file and store its content. ai_settings = None - if os.path.exists('ai_settings.yaml'): - with open('ai_settings.yaml', 'r') as f: + if os.path.exists("ai_settings.yaml"): + with open("ai_settings.yaml", "r") as f: ai_settings = f.read() - os.remove('ai_settings.yaml') + os.remove("ai_settings.yaml") try: - if os.path.exists('hello_world.txt'): + if os.path.exists("hello_world.txt"): # Clean up any existing 'hello_world.txt' file before testing. - delete_file('hello_world.txt') + delete_file("hello_world.txt") # Prepare input data for the test. - input_data = '''write_file-GPT + input_data = """write_file-GPT an AI designed to use the write_file command to write 'Hello World' into a file named "hello_world.txt" and then use the task_complete command to complete the task. Use the write_file command to write 'Hello World' into a file named "hello_world.txt". Use the task_complete command to complete the task. Do not use any other commands. y -5 -EOF''' - command = f'{sys.executable} -m autogpt' +EOF""" + command = f"{sys.executable} -m autogpt" # Execute the script with the input data. - process = subprocess.Popen(command, stdin=subprocess.PIPE, shell=True, env={**os.environ, **env_vars}) + process = subprocess.Popen( + command, + stdin=subprocess.PIPE, + shell=True, + env={**os.environ, **env_vars}, + ) process.communicate(input_data.encode()) # Read the content of the 'hello_world.txt' file created during the test. - content = read_file('hello_world.txt') + content = read_file("hello_world.txt") finally: if ai_settings: # Restore the original ai_settings.yaml file. - with open('ai_settings.yaml', 'w') as f: + with open("ai_settings.yaml", "w") as f: f.write(ai_settings) # Check if the content of the 'hello_world.txt' file is equal to 'Hello World'. - self.assertEqual(content, 'Hello World', f"Expected 'Hello World', got {content}") + self.assertEqual( + content, "Hello World", f"Expected 'Hello World', got {content}" + ) # Run the test case. -if __name__ == '__main__': +if __name__ == "__main__": unittest.main() diff --git a/tests/test_token_counter.py b/tests/test_token_counter.py index 42670e60..81e68277 100644 --- a/tests/test_token_counter.py +++ b/tests/test_token_counter.py @@ -4,18 +4,17 @@ from autogpt.token_counter import count_message_tokens, count_string_tokens class TestTokenCounter(unittest.TestCase): - def test_count_message_tokens(self): messages = [ {"role": "user", "content": "Hello"}, - {"role": "assistant", "content": "Hi there!"} + {"role": "assistant", "content": "Hi there!"}, ] self.assertEqual(count_message_tokens(messages), 17) def test_count_message_tokens_with_name(self): messages = [ {"role": "user", "content": "Hello", "name": "John"}, - {"role": "assistant", "content": "Hi there!"} + {"role": "assistant", "content": "Hi there!"}, ] self.assertEqual(count_message_tokens(messages), 17) @@ -25,7 +24,7 @@ class TestTokenCounter(unittest.TestCase): def test_count_message_tokens_invalid_model(self): messages = [ {"role": "user", "content": "Hello"}, - {"role": "assistant", "content": "Hi there!"} + {"role": "assistant", "content": "Hi there!"}, ] with self.assertRaises(KeyError): count_message_tokens(messages, model="invalid_model") @@ -33,13 +32,15 @@ class TestTokenCounter(unittest.TestCase): def test_count_message_tokens_gpt_4(self): messages = [ {"role": "user", "content": "Hello"}, - {"role": "assistant", "content": "Hi there!"} + {"role": "assistant", "content": "Hi there!"}, ] self.assertEqual(count_message_tokens(messages, model="gpt-4-0314"), 15) def test_count_string_tokens(self): string = "Hello, world!" - self.assertEqual(count_string_tokens(string, model_name="gpt-3.5-turbo-0301"), 4) + self.assertEqual( + count_string_tokens(string, model_name="gpt-3.5-turbo-0301"), 4 + ) def test_count_string_tokens_empty_input(self): self.assertEqual(count_string_tokens("", model_name="gpt-3.5-turbo-0301"), 0) @@ -47,7 +48,7 @@ class TestTokenCounter(unittest.TestCase): def test_count_message_tokens_invalid_model(self): messages = [ {"role": "user", "content": "Hello"}, - {"role": "assistant", "content": "Hi there!"} + {"role": "assistant", "content": "Hi there!"}, ] with self.assertRaises(NotImplementedError): count_message_tokens(messages, model="invalid_model") @@ -57,5 +58,5 @@ class TestTokenCounter(unittest.TestCase): self.assertEqual(count_string_tokens(string, model_name="gpt-4-0314"), 4) -if __name__ == '__main__': +if __name__ == "__main__": unittest.main() From 93b3e8428cadf42781122246396699dacc6ea61a Mon Sep 17 00:00:00 2001 From: BillSchumacher <34168009+BillSchumacher@users.noreply.github.com> Date: Sat, 15 Apr 2023 15:03:03 -0500 Subject: [PATCH 76/78] Update llm_utils.py Fix trailing whitespace --- autogpt/llm_utils.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/autogpt/llm_utils.py b/autogpt/llm_utils.py index 2e77db10..043745aa 100644 --- a/autogpt/llm_utils.py +++ b/autogpt/llm_utils.py @@ -115,7 +115,7 @@ def create_chat_completion( return response.choices[0].message["content"] -def create_embedding_with_ada(text) -> list: +def create_embedding_with_ada(text) -> list: """Create a embedding with text-ada-002 using the OpenAI SDK""" num_retries = 10 for attempt in range(num_retries): From e758a4de3eaef2aaaf6e10ba16929ad633572926 Mon Sep 17 00:00:00 2001 From: BillSchumacher <34168009+BillSchumacher@users.noreply.github.com> Date: Sat, 15 Apr 2023 15:03:33 -0500 Subject: [PATCH 77/78] Update pinecone.py Fix blank lines. --- autogpt/memory/pinecone.py | 1 + 1 file changed, 1 insertion(+) diff --git a/autogpt/memory/pinecone.py b/autogpt/memory/pinecone.py index 3817436d..d781073e 100644 --- a/autogpt/memory/pinecone.py +++ b/autogpt/memory/pinecone.py @@ -5,6 +5,7 @@ from autogpt.logs import logger from autogpt.memory.base import MemoryProviderSingleton from autogpt.llm_utils import create_embedding_with_ada + class PineconeMemory(MemoryProviderSingleton): def __init__(self, cfg): pinecone_api_key = cfg.pinecone_api_key From 8978844111b594e3ee0727f87223f02fa008d1a3 Mon Sep 17 00:00:00 2001 From: BillSchumacher <34168009+BillSchumacher@users.noreply.github.com> Date: Sat, 15 Apr 2023 15:17:23 -0500 Subject: [PATCH 78/78] Update llm_utils.py Remove pass --- autogpt/llm_utils.py | 1 - 1 file changed, 1 deletion(-) diff --git a/autogpt/llm_utils.py b/autogpt/llm_utils.py index 4e74566b..238ac560 100644 --- a/autogpt/llm_utils.py +++ b/autogpt/llm_utils.py @@ -100,7 +100,6 @@ def create_chat_completion( Fore.RED + "Error: ", f"Reached rate limit, passing..." + Fore.RESET, ) - pass except APIError as e: if e.http_status == 502: pass