Tencent je objavio hy-memory==2.0.1, Python SDK za čuvanje i pronalaženje konteksta iz sesija ćaskanja, rada i programiranja. Kod je javan; prateća aplikacija MemHub još je izvorni kod koji čeka javne artefakte izdanja. Programeri koji procenjuju zajednički sloj memorije već mogu da koriste SDK, ali moraju da obezbede krajnje tačke modela i ugrađivanja i odluče koje zapise sesija svaki agent sme da čita.

U dnevniku izmena projekta Hy Memory 2.0.1 je datiran na 16. oktobar 2026. PyPI beleži otpremanje paketa 15. oktobra, a povezani rad o modelu predat je istog dana. To su zasebni zapisi objavljivanja, a ne dokaz da je desktop proizvod isporučen.

Velika promena

  • Šta se promenilo: Objavljeni SDK pruža zasebne putanje memorije za ćaskanje, rad i programiranje preko add() i search(), uz filtere izvora i radnog prostora koje aplikacija koja ga integriše može da koristi.
  • Kako radi: Ćaskanje organizuje razgovore u slojeve memorije. Rad iz traga alata izdvaja činjenicu o sesiji i, kada je opravdano, ponovno upotrebljiva iskustva. Programiranje dodaje lanac verzija izmena koda. Pozivalac obezbeđuje izvorni materijal, identitete, podešavanja skladištenja i usluge modela.
  • Zašto je važno: Okruženje koje pokreće agenta može da preuzme sažet zapis prethodnih razgovora ili odluka o zadacima umesto da u svaku novu sesiju prosleđuje celu istoriju. Da li je taj zapis tačan, odobren i koristan i dalje zavisi od onoga što okruženje šalje i od toga koja sećanja dopušta da se vrate u upit modelu.

Izaberite tok rada pre integracije

Dokument SDK README opisuje tri vrednosti parametra scene. chat prihvata običan tekst ili nizove poruka, a zatim vraća kanale prisećanja profile, normal i proactive. U režimu lite čuva sirov tekst za pretragu po ugrađivanjima, bez izdvajanja pomoću LLM-a. pro dodaje izdvajanje i usklađivanje; ultra može da izvrši dodatni prolaz evolucije preko evolve().

Za working ulaz mora da sadrži trag poziva alata. Sesija proizvodi jednu činjenicu o zadatku, pristupu i rezultatu, uz nula ili više ponovno upotrebljivih iskustava koja prelaze prag vrednosti mehanizma. coding koristi ista dva sloja i dodaje lanac evolucije verzija za izmenjeni kod. README navodi da lanac može da koristi lokalne Git razlike ako je podešen MEMORY_CODING_CHAIN_REPO_ROOT, ili determinističke radnje zamene u tragu alata. U režimu lite SDK zanemaruje razliku između radnog i programerskog scenarija i čuva sirovu memoriju.

Ovi oblici izlaza služe različitim pitanjima. Preferencija iz razgovora pripada scenariju chat; završen zadatak sa rezultatima alata pripada režimu working; izmena koda čija ranija revizija može biti važna pripada režimu coding. To je dokumentovana razlika u usmeravanju, a ne BIG CHANGE test performansi.

Dokumentovan put za upotrebu SDK-a

Sledeći niz koraka zasnovan je na brzom početku u repozitorijumu i MemHub-ovom vodiču za podešavanje SDK-a. BIG CHANGE nije pokretao paket niti slao pozive modelima.

Koristite Python 3.9 ili noviji i instalirajte fiksiranu verziju SDK-a:

Terminal
pip install hy-memory==2.0.1

ChromaDB i Kuzu su deo osnovnog skupa zavisnosti; Qdrant, FAISS, Neo4j, MySQL keš i lokalni model za ponovno rangiranje imaju zasebne dodatke. Okruženje za razvoj izvornog koda MemHub-a je drugačije: zahteva Node.js 24, pnpm 11, Python 3.12 i uv.

Podesite i krajnju tačku LLM-a i krajnju tačku za ugrađivanja pre inicijalizacije klijenta. README navodi MEMORY_LLM_API_KEY, MEMORY_LLM_BASE_URL, MEMORY_LLM_MODEL i odgovarajuće promenljive MEMORY_EMBEDDER_*, uz MEMORY_EMBEDDING_DIMS; takođe dokumentuje podrazumevanu vrednost OPENAI_API_KEY. Obezbedite sopstvene URL adrese krajnjih tačaka, nazive modela, ključeve i odgovarajuće dimenzije ugrađivanja. To su interfejsi kompatibilni sa OpenAI-jem, a ne zahtev da se koristi Tencent-ov zasebni model Hy-Memory-30B. Ne uključujte akreditive u tragove koji se čuvaju.

Sledeći primer ćaskanja koristi dokumentovane API-je MemoryConfig.from_env(), HyMemoryClient, add() i search(). Aplikacija koja poziva mora da obezbedi authorized_messages kao običan tekst ili poruke u OpenAI formatu, stabilan odobreni identifikator user_id i upit query. Primer prikazuje povratnu vrednost bez tvrdnje o određenom rezultatu:

Python
from hy_memory import HyMemoryClient, MemoryConfig

def write_and_recall(authorized_messages, user_id, query):
    config = MemoryConfig.from_env()  # Caller supplies LLM and embedding settings.
    client = HyMemoryClient(config=config, mode="pro")
    try:
        client.add(authorized_messages, user_id=user_id)
        return client.search(query, user_ids=[user_id], limit=10)
    finally:
        client.close()

Za rad ili programiranje prosledite trag poruka koji sadrži poziv alata ili stavku role="tool" i izričito podesite scene. Podesite workspace_id da izdvojite materijal projekta; branch ga zahteva. Podesite source pri upisu, a include_sources ili exclude_sources pri pretrazi kada su granice aplikacije pozivaoca važne. Pretraga ćaskanja vraća kanale memorije; pretraga rada ili programiranja vraća facts i experiences, uz chain_block za programiranje. Pregledajte vraćene zapise pre nego što ih predate okruženju koje pokreće agenta. list_memories, get, update i delete omogućavaju upravljanje pojedinačnim zapisima.

Uspešna integracija imala bi sačuvan zapis iz odobrenog ulaza i rezultat pretrage u zadatom opsegu koji odgovara na predviđeno pitanje prisećanja. README dokumentuje povratna polja, ali nemamo posmatrano izvršavanje na osnovu kog bismo tvrdili da su izdvajanje ili prisećanje uspeli. Ako je pretraga rada ili programiranja prazna, prvo proverite da je upis sadržao rezultate alata i koristio pro ili ultra, pa proverite iste vrednosti user_id, workspace_id, branch i filtere izvora. Ako menjate model ili dimenzije ugrađivanja, MemHub-ov vodič za podešavanje upozorava da se postojeća kolekcija ne može jednostavno ponovo koristiti sa drugačijom širinom vektora.

MemHub i model su zasebni izbori

MemHub je predloženi desktop i CLI proizvod izgrađen na SDK-u. Njegov README opisuje upravljano lokalno izvršno okruženje, konektore izvora i integracije sa okruženjima domaćinima. Njegov dnevnik izmena preciznije opisuje dostupnost: postoji izvorna verzija 1.0.0, izdanje 4, ali su npm objava i GitHub artefakti izdanja još na čekanju. Vodič za instalaciju navodi Linux i macOS kao ciljne platforme i kaže da Windows nije podržan; njegov niz npm instalacionih koraka uslovljen je objavljivanjem tih artefakata. Za sada taj niz tretirajte kao planiran put instalacije.

Lokalno skladištenje takođe ne znači da svaki korak obrade ostaje lokalan. MemHub-ov dokument o privatnosti razdvaja dozvolu za čitanje izvora razgovora, dozvolu za slanje odobrenog materijala izabranoj usluzi modela treće strane i dozvolu da okruženje koje pokreće agenta preuzme memoriju. Navodi da se sirovi izvorni dokazi čuvaju u lokalnom direktorijumu podataka i da spoljna usluga modela, kada je izabrana, dobija odobren sadržaj potreban za odabrani zadatak. Integrator koji neposredno koristi SDK mora da sprovede sopstvene kontrole saglasnosti za izvore, pristupa modelima i prisećanja u okruženju domaćina; MemHub-ov vodič za integraciju kaže da njegov proizvodni most dodaje te korake upravljanja umesto da samo poziva SDK.

Tencent je objavio i Hy-Memory-30B-A3B, model obučen za upisivanje memorije, uz tehnički izveštaj predat 15. oktobra. Izveštaj tvrdi da model prednjači nad uporednim sistemima na fiksnim poduzorcima testova. To je ocena modela koju navodi dobavljač, a ne nezavisan dokaz da ovaj SDK ili MemHub poboljšavaju odgovore agenta u upotrebi. SDK prihvata druge kompatibilne usluge modela.

Trenutni fajl licence repozitorijuma i metapodaci projekta navode Apache-2.0. Dnevnik izmena kaže da je usvojen posle otpremanja verzije 2.0.1, čiji nepromenljivi PyPI metapodaci i dalje navode MIT. Paket se besplatno preuzima, ali izabrana usluga modela ili ugrađivanja može da naplaćuje zahteve; izdanje ne dokumentuje univerzalnu cenu rada. Praktična odluka je zato koju putanju memorije i granicu ovlašćenja integrisati, uz merenje troškova dobavljača i kvaliteta prisećanja u sopstvenoj postavci programera.

Izvori i dodatna literatura