ეს არის წარდგენა Hacktoberfest Open-Source AI Challenge Week 4: Ghost in the Machine-ისთვის
რა ავაშენე
"ყველა კოდბაზას აქვს მოჩვენებები. თითქმის ყველა საწარმოო რეპოზიტორიასა და ღია კოდის პროექტში არის ერთი „შეჩვენებული“ ფაილი, რომელზეც წერია
// DO NOT TOUCH: NOBODY KNOWS WHY THIS WORKS. როცა ორიგინალი ავტორი წავა, მისი დომენის ცოდნა ეთერში გაქრება. კოდი ნელ-ნელა ლპება, დამოკიდებულებები ძველდება და შიში არავის აძლევს საშუალებას, მას შეეხოს."
Hacktoberfest-ის მეოთხე კვირისთვის — რომელიც ჰელოუინსა და Día de los Muertos-ს ემთხვევა — ავაშენე GitSéance: ღია კოდის AI Code Necromancer, რომელიც ძველი კოდის სასაფლაოს ინტერაქტიურ, მიწაზე დაფუძნებულ სეანსად აქცევს.
_____ _____ _______ _____ ______ _ _ _____ ______
/ ____|_ _|__ __| / ____| ____| /\ | \ | |/ ____| ____|
| | __ | | | | | (___ | |__ / \ | \| | | | |__
| | |_ | | | | | \___ \| __| / /\ \ | . ` | | | __|
| |__| |_| |_ | | ____) | |____ / ____ \| |\ | |____| |____
\_____|_____| |_| |_____/|______/_/ \_\_| \_|\_____|______|
ჩვეულებრივი ლინტერის ნაცვლად, GitSéance აკოორდინირებს 4 სპეციალიზებულ ნეკრომანტიის აგენტს:
-
💀 The Reaper Agent: გადის Git commit-ების ხესა და ფაილის AST-ს, რათა commit-ების ისტორიის, ავტორების ცვლილებისა და ჩაშენებული შიშის კომენტარების (
hack,black magic,do not touch) მიხედვით იპოვოს მიტოვებული, ობოლი და დაწყევლილი კოდი. - 📊 The Oracle Agent (TabPFN-3.5): ქმნის 7-განზომილებიან ფორენზიკულ feature vector-ს და აწვდის მას Prior Labs-ის TabPFN tabular foundation model-ს, რათა კალიბრირებული ფაილის სიკვდილის რისკი იწინასწარმეტყველოს.
-
🔮 The Medium Agent (Google Gemma): გარდაცვლილი ავტორების სულს Google-ის Gemma open-weight მოდელის (
gemma-4-26b-a4b-it) მეშვეობით ახმოვანებს და ქმნის პირველ პირში დაწერილ აღიარებებს, სინანულის ანალიზსა და თანამედროვე აღდგენის გეგმებს. - 🔍 The Searcher Agent (SerpApi): ეძებს ცოცხალ 2026 წლის პაკეტების რეესტრებსა და უსაფრთხოების ბაზებს, რათა მიტოვებული დამოკიდებულებებისთვის თანამედროვე ჩანაცვლებები იპოვოს და CVE მოხსენებები შეამოწმოს.
ამ აგენტებს ინტერაქტიური სეანსის შესაძლებლობები ამოძრავებს:
- 💬 Conversational Séance (ინტერაქტიური მოჩვენებასთან ჩატი): ცოცხალ დეველოპერებს შეუძლიათ მოჩვენებასთან რეალურ დროში პირდაპირ ისაუბრონ და ჰკითხონ, რატომ დაიწერა კონკრეტული hack-ები და როგორ შეიძლება მათი უსაფრთხოდ რეფაქტორინგი.
- 🔊 Neural Voice Deck (ElevenLabs): მოჩვენებას ხმას აძლევს ნეირონული text-to-speech-ით, სინქრონიზებული Web Audio API ტალღური ფორმის ვიზუალიზატორით.
- 🪦 Official Post-Mortem Autopsy Certificates: ქმნის ჩამოსატვირთ ვინტაჟურ ASCII მოწმობებს, სადაც აღწერილია სიკვდილის მიზეზი, bus factor და TabPFN-ის სიკვდილიანობის ქულა.
- 📊 7D Tabular CSV Forensic Exporter: ერთი დაწკაპუნებით ჩამოიტვირთება მთლიანი ცხრილური feature dataset ოფლაინ TabPFN მოდელის შესწავლისა და აუდიტისთვის.
-
🛡️ Live GitHub SVG Mortality Badges: დინამიკური shields endpoint (
/api/badge/{owner}/{repo}.svg) რეპოზიტორიის ცოცხალი სიკვდილიანობის ქულის README ფაილებში ჩასმისთვის.
ეს ყველაფერი შემოსილია ავთენტურ ფოსფორისფერ-მწვანე CRT ტერმინალის ინტერფეისში, მინის სკანირების ხაზებით, CRT ვინიეტით, მექანიკური კლავიშების სინთეზით და მოლივლივე ექტოპლაზმის ნაწილაკებით.
დემო
ცოცხალი პროდაქშენ დეპლოიმენტი
- 🌐 ცოცხალი ტერმინალი: https://gitseance.onrender.com
- 💻 GitHub რეპოზიტორია: https://github.com/JaniDhruv/GitSeance
-
🛡️ ცოცხალი სიკვდილიანობის ბეჯი:
(რჩევა: ცოცხალი აპლიკაციის გახსნისას დააწკაპუნეთ ისტორიულ პრესეტზე 🐍 flask-cache (Python 2 Fossil), რომ მაშინვე 10 წლის ფოსილური რეპოზიტორია გამოიძახოთ!)
🖥️ ფოსფორისფერ-მწვანე CRT ტერმინალის ინტერფეისი
GitSéance ტერმინალის ვიზუალური მიმოხილვა მოქმედებაში — მინის სკანირების ხაზები, TabPFN სიკვდილიანობის ანალიზი, ცოცხალი SerpApi modernization ხე და ინტერაქტიული Gemma მოჩვენების არხი:
სეანსის სამსხვერპლო — ფოსფორისფერ-მწვანე CRT დაფა, რომელზეც ნაჩვენებია აგენტების ცოცხალი სტატუსის ინდიკატორები, ისტორიული სასაფლაოს პრესეტები და რეალურ დროში მიმდინარე ნეკრომანტიის ჟურნალები.
ორაკული (TabPFN-3.5) სკანირება — ბაიესური კოდის სიკვდილიანობის ალბათობები, ფაილების რისკის კატეგორიზაცია (Dead, Haunted, Orphaned) და Google Gemma-ს კოდის პროგნოზი.
არხით გადმოცემული მოჩვენების გადაცემა — Google Gemma პერსონა, რომელიც Makefile-ის გარდაცვლილ ავტორს ახმოვანებს, ElevenLabs ხმის სინთეზითა და რეალურ დროში აუდიო ტალღური ვიზუალიზატორით.
აღდგენის ბლუფრინტი & SerpApi ინტელექტი — კონკრეტული modernization ნაბიჯები, დაწყვილებული 2026 წლის ცოცხალ დამოკიდებულების ალტერნატივებთან, რომლებიც რეალურ დროში SerpApi-ით იქნა მოძიებული.
კოდის აუტოფსიის მოწმობა — ოფიციალური ვინტაჟური ASCII პოსტმორტემ აუტოფსიის უჯრა, სადაც აღწერილია ვადის გასვლის თარიღი, დაფიქსირებული bus factor და TabPFN სიკვდილიანობის ქულა.
ნეირონული ხმის დეკი & MP3 ექსპორტი — ElevenLabs სპექტრალური ხმის სტრიმინგი აქტიური ტალღური ვიზუალიზატორითა და ერთი დაწკაპუნებით MP3 ჩამოტვირთვით.
ინტერაქტიული მოჩვენების ჩატი (პირველი რეპლიკა) — Thadeus Burgess-ის სულის დაკითხვა იმის შესახებ, თუ რატომ გამოიყენეს ძველი setup.py პაკეტირება.
ინტერაქტიული მოჩვენების ჩატი (მეორე რეპლიკა) — მოჩვენება აღიარებს, რომ გამოშვებამდე 2 საათზე ღამით საგანგებო hack დატოვა: "Please, bury it for me."
დეტალური სვლა: flask-cache-ის მოჩვენების გამოძახება
როცა სკანირდება thadeusb/flask-cache (ძველი Python 2 ქეშირების ბიბლიოთეკა, რომელსაც 2010 წლიდან არავინ შეხებია):
-
The Reaper გადის commit-ების ხეზე და
Makefile-ს აფიქსირებს როგორც კლინიკურად მკვდარს (ბოლოს შეხებული იყო 5,986 დღის წინ). - TabPFN-3.5 აფასებს 7D feature vector-ს (ნულოვანი churn, 100% ავტორების ცვლილება, მოუხერხებელი unit ტესტები) და წინასწარმეტყველებს 80% სიკვდილიანობის ალბათობას.
- The Medium (Gemma 4) ახმოვანებს შემქმნელ Thadeus Burgess-ს, როლში მეტყველებს: > "მე ვარ Thadeus Burgess-ის გაუჩინარებული ექო. 2010-08-30T09:39:36Z დროს გავაკეთე ჩემი ბოლო commit: 'R-0.1'. მერე წავედი სიბნელეში და Makefile დავტოვე, რომ დროში გაყინულიყო."
-
ElevenLabs აღიარებას ჩურჩულით კითხულობს (Roger — Ancient Architect ხმის პრესეტი), რეალურ დროში ტალღურ ვიზუალიზაციასა და ერთი დაწკაპუნებით
⬇️ Download MP3ექსპორტით!- 🎧 მოისმინეთ გენერირებული აუდიო: ჩამოტვირთეთ/მოისმინეთ ნედლი MP3 ჩანაწერი ჩემს რეპოზიტორიაში
-
SerpApi ამოიცნობს მოძველებულ
setup.py uploadპაკეტირების ბრძანებებს და გვირჩევს თანამედროვე ჩანაცვლებებს, როგორიცააbuild,twineდაpyproject.toml. - თქვენ ხსნით ინტერაქტიულ სეანსის ჩატს და პირდაპირ ეკითხებით მოჩვენებას:
- თქვენ: "რატომ გამოიყენეთ setup.py upload და არა თანამედროვე twine პაკეტირება?"
-
მოჩვენება (Thadeus Burgess): "აა, გკითხავთ, რატომ დავწერე ასე
Makefile-ში... მაშინ საათს ვეჯიბრებოდით. ბიბლიოთეკები, რომლებსაც 2026 წელს თავისთავად ვიღებთ, არ არსებობდა, მეხსიერება კი ცოტა იყო. ეს იყო საუკეთესო კომპრომისი, რაც მოვიფიქრე." - თქვენ: "არის რაიმე საიდუმლო hack ან საშიშროება, თუ დღეს ამ Makefile-ს რეფაქტორინგს ან წაშლას მოვინდომებ?"
-
მოჩვენება (Thadeus Burgess): "ნაწიბური შეამჩნიეთ, არა? დიახ, ეს hack
Makefile-ში დავტოვე 2 საათზე ღამით, გამოშვებამდე. დავპირდი საკუთარ თავს, რომ იმ კვირაობით გადავაკეთებდი... მაგრამ იგი კვირაობა არ დადგა. გთხოვთ, დამმარხეთ იგი."
- თქვენ დააწკაპუნებთ "🪦 Print Death Certificate"-ზე და იღებთ ოფიციალურ ASCII პოსტმორტემ აუტოფსიას:
+========================================================================+
| 💀 OFFICIAL CODE AUTOPSY 💀 |
| DEPARTMENT OF SOFTWARE NECROMANCY |
+========================================================================+
| DECEASED ARTIFACT : Makefile |
| CHIEF ARCHITECT : Thadeus Burgess |
| DATE OF EXPIRATION : 2010-08-30 (5,986 days inactive) |
| FINAL RECORDED WORDS: "R-0.1" |
| TOTAL COMMITS : 2 commits across file lifetime |
| RECORDED BUS FACTOR : 1 author(s) recorded in blame |
| HAUNTING STATUS : DEAD |
| TABPFN MORTALITY : 80% Bayesian mortality risk |
| GHOST SEVERITY : 0.80 / 1.00 index |
+------------------------------------------------------------------------+
| GHOST TESTIMONY: |
| "I am Thadeus, a fragment of logic drifting through a sea of |
| deprecated dependencies. I linger in the shadows of these old |
| Makefiles, waiting for a build that will never finish. Do not fear |
| the silence; fear the unhandled exception." |
+------------------------------------------------------------------------+
| REVIVAL EFFORT : REWRITE |
| CERTIFICATE STAMP : GITSEANCE FORENSIC ENGINE v1.0.0 |
| AI RUNTIMES : TABPFN-3.5 + GOOGLE GEMMA + ELEVENLABS |
+========================================================================+
- თქვენ დააწკაპუნებთ "📋 Copy Revival Blueprint"-ზე, რათა მიიღოთ მყისიერი, პრაქტიკული ნაბიჯ-ნაბიჯ მიგრაციის ბლუფრინტი:
REVIVAL BLUEPRINT FOR: Makefile
Summary: Transmute this ancient ritual into a modern, declarative build system.
Effort: rewrite
STEPS:
1. Transition from `setup.py` to a `pyproject.toml` configuration.
2. Replace the manual upload commands with `twine` for secure distribution.
3. Use the `build` module for generating distribution archives.
4. Implement a modern test runner like `pytest` instead of the legacy `setup.py test`.
კოდი
JaniDhruv
/
GitSeance
🔮 ყველა კოდბაზას აქვს მოჩვენებები. GitSeance არის ღია კოდის AI code necromancer & ფორენზიკის აგენტი, რომელიც სკანირებს ძველ GitHub რეპოზიტორიებს მკვდარი ფაილების მოსაძებნად, წინასწარმეტყველებს კოდის სიკვდილიანობის რისკს TabPFN-3.5 tabular ML-ით, ახმოვანებს თავდაპირველი ავტორის სულს Gemma 3-ით ElevenLabs ხმის სინთეზით და აფუძნებს თანამედროვე აღდგენის პატჩებს SerpApi-ით.
🔮 GitSéance (GitSeance)
_____ _____ _______ _____ ______ _ _ _____ ______
/ ____|_ _|__ __| / ____| ____| /\ | \ | |/ ____| ____|
| | __ | | | | | (___ | |__ / \ | \| | | | |__
| | |_ | | | | | \___ \| __| / /\ \ | . ` | | | __|
| |__| |_| |_ | | ____) | |____ / ____ \| |\ | |____| |____
\_____|_____| |_| |_____/|______/_/ \_\_| \_|\_____|______|
ღია კოდის AI ნეკრომანტი, რომელიც „მკვდარ“ GitHub რეპოზიტორიებს აცოცხლებს — და წინასწარმეტყველებს, რომელი ფაილები მოკვდება შემდეგი.
სლოგანი: "ყველა კოდბაზას აქვს მოჩვენებები. GitSéance მათ არხით გადასცემს."
🌐 ცოცხალი დემო: https://gitseance.onrender.com
შექმნილია Hacktoberfest Open-Source AI Challenge: Week 4-ისთვის ("Ghost in the Machine").
📸 საწარმოო გალერეა
🔮 ფოსფორისფერ-მწვანე CRT ტერმინალი ცოცხალი AI სტატუსითა და მოქმედი ნეკრომანტიის ჟურნალებით
📊…
GitHub-ზე ნახვაგავრცელებულია MIT ლიცენზიით. შემოწმებულია 25 unit და ინტეგრაციული ტესტით, რომლებიც continuous integration-ზე გადის.
როგორ ავაშენე
GitSéance შეიქმნა როგორც ასინქრონული მრავალაგენტური pipeline, რომელსაც FastAPI ამუშავებს:
┌───────────────────────────────┐
│ Haunted Terminal (CRT UI) │
└──────────────┬────────────────┘
│
▼
FastAPI Orchestration Core
│
┌──────────────┬───────────────┴───────────────┬──────────────┐
▼ ▼ ▼ ▼
💀 The Reaper 📊 The Oracle 🔮 The Medium 🔍 The Searcher
(Dead Code AST) (TabPFN-3.5 Mortality ML) (Gemma LLM) (SerpApi Web Search)
│ │ │ │
▼ ▼ ▼ ▼
GitHub API Prior Labs API Google GenAI SerpApi & CVEs
1. TabPFN-3.5: ბაიესური ცხრილური კოდის სიკვდილიანობის პროგნოზი
მარტივი წესებზე დაფუძნებული ევრისტიკების წერის ნაცვლად, გამოვიყენე Prior Labs-ის TabPFN-3.5 — ცხრილური foundation მოდელი, რომელიც Prior-Data Fitted Networks-ზეა აგებული.
7D ფორენზიკული Feature Vector
სამიზნე რეპოზიტორიის ყოველი ფაილისთვის GitSéance ქმნის 7-განზომილებიან ცხრილურ მატრიცას:
# Extracted 7D Forensic Feature Vector for TabPFN-3.5
feature_vector = {
"days_since_last_commit": m.days_since_last_commit, # Temporal decay
"total_commits": m.total_commits, # File depth
"unique_authors": m.unique_authors, # Bus factor risk
"bug_fix_commit_ratio": m.bug_fix_commit_ratio, # Defect density
"lines_ratio": (m.lines_added + 1) / (m.lines_del + 1), # Churn balance
"has_tests": 1 if m.has_tests else 0, # Test presence
"churn_velocity": m.churn_velocity, # Monthly change rate
}
საბაზისო კალიბრაცია და გამონაკლისი შემთხვევების გადაწყვეტა
TabPFN იყენებს in-context ბაიესურ დასკვნას საცნობარო support მატრიცაზე (X_train, y_train), რომელიც კალიბრირებულია 50 ისტორიულ ღია კოდის არტეფაქტზე (25 გარდაცვლილი ფოსილი დაარქივებული რეპოზიტორიებიდან vs. 25 აქტიურად შენარჩუნებული მოდული fastapi, pydantic და requests-დან).
რატომ სჯობს TabPFN ნაივურ ევრისტიკებს:
ნაივური ლინტერი ფაილს, რომელსაც 3 წელია არ შეხებიათ, ბრმად მონიშნავს როგორც „მკვდარს“. მაგრამ განვიხილოთ მათემატიკური ძირითადი utility (მაგ. slugify.py ან crc32.py):
-
days_since_last_commit: 1,100 დღე -
bug_fix_commit_ratio: 0.02 (თითქმის ნულოვანი დეფექტი) -
has_tests: True (100% branch coverage) -
churn_velocity: 0.00 (სტაბილური)
ნაივური წესი ამას მკვდრად მონიშნავს (100% ცრუ პოზიტივი). TabPFN სწორად აფასებს ტესტების მაღალ სიგნალს და თითქმის ნულოვან დეფექტების კოეფიციენტს და მას აკლასიფიცირებს როგორც "FROZEN / STABLE" (სიკვდილიანობა: 18%), და არა DEAD-ად. პირიქით, 180 დღის განმავლობაში შეუხებელი ფაილი, რომელსაც ერთადერთი გარდაცვლილი ავტორი ჰყავს და 60% bug-fix კოეფიციენტი აქვს, TabPFN-ის მიერ დაფიქსირდება როგორც "HIGH MORTALITY RISK" (78%).
ამის სრულად გამჭვირვალედ გასაკეთებლად:
-
📊 7D ცხრილური CSV ექსპორტი: მომხმარებლებსა და შემფასებლებს შეუძლიათ დააწკაპუნონ "📊 Export CSV"-ზე და ჩამოტვირთონ feature განაწილების ნედლი მონაცემები (
tabpfn-<repo>-forensic-dataset.csv). -
🔌 ნატიური MCP სერვერი (
backend/mcp_server.py): ასრულებს Prior Labs-ის ცხადად გამოხატულ პრეფერენციას დაtabpfn_predict_mortality-ს პირდაპირ Model Context Protocol ინსტრუმენტად ავლენს Cursor-ისთვის, Claude Desktop-ისთვის და Copilot-ისთვის!
2. Google Gemma: სულიერი პერსონის არხი და აზროვნების ტოკენების დამუშავება
The Medium აგენტი google-genai SDK-ის მეშვეობით აწარმოებს Google-ის Gemma open-weight მოდელს (gemma-4-26b-a4b-it).
აზროვნების ტოკენების დამუშავების გამოწვევა
gemma-4-26b-a4b-it-ს აქვს შიდა chain-of-thought მსჯელობა. სულიერი მონოლოგების გენერირებისას მოდელი პერსონაჟის რეპლიკამდე გამოსცემს აზროვნების ტოკენებს. ნაივური დამუშავებისას შიდა მსჯელობის ტოკენებმა შეიძლება მთელი გამომავალი ბიუჯეტი ამოწურონ ან მონოლოგში შემოიჭრან.
დავაპროექტე სპეციალური კანდიდატების ამომღები:
@staticmethod
def _extract_text(response) -> str:
"""Extract content text from Gemma response, filtering thought tokens."""
if not response:
return ""
# 1. Prioritize candidate parts inspection to filter out internal chain-of-thought tokens
if hasattr(response, "candidates") and response.candidates:
candidate = response.candidates[0]
if hasattr(candidate, "content") and hasattr(candidate.content, "parts"):
actual_parts = [
p.text for p in candidate.content.parts
if not getattr(p, "thought", False) and getattr(p, "text", None)
]
if actual_parts:
return "".join(actual_parts).strip()
# 2. Fallback to response.text if candidate parts are not directly accessible
if hasattr(response, "text") and response.text:
return response.text.strip()
return ""
პერსონაჟის დამყარება
მოჩვენების პერსონა მკაცრად დაფუძნებულია git-ისტორიასა და ჩაშენებულ კომენტარებზე:
SEANCE_SYSTEM_PROMPT = """You are the ghost of a software developer. You died — meaning you left this project —
and your spirit now haunts the codebase. You are being summoned in a séance to explain the code you left behind.
When channeled, you will:
1. Explain WHY you wrote the code the way you did (constraints, tech landscape at the time)
2. Confess what you wish you had done differently (unfinished business)
3. Give concrete, modern advice for reviving or replacing the code
Speak with the voice of someone who lived through the decisions. Keep it vivid, personal, and under 300 words."""
ცოცხალ დეველოპერებს შეუძლიათ Conversational Séance-ის (POST /api/seance/chat) გახსნა და მოჩვენებას პირდაპირ დამატებითი კითხვები დაუსვან!
3. SerpApi: ცოცხალი 2026 დამოკიდებულებების ინტელექტი
The Searcher აგენტი ამუშავებს პაკეტების დეკლარაციებს (requirements.txt, package.json, Gemfile, go.mod) და SerpApi-ით რეალურ დროში ეძებს მიგრაციის გზებს, თანამედროვე ჩანაცვლებებსა და ცოცხალ CVE უსაფრთხოების ბაზებს.
4. ElevenLabs: ნეირონული აუდიო სინთეზი და ერთი დაწკაპუნებით MP3 ექსპორტი
სეანსის გადაცემები გარდაიქმნება მეტყველებად ElevenLabs Neural TTS-ით (eleven_multilingual_v2), რომელსაც უჭერს მხარს Web Audio API-ზე დაფუძნებული პროცედურული სინთეზის ძრავა, რომელიც რეტრო მექანიკური კლავიატურის კლავიშებსა და დაბალსიხშირულ რეზონანსულ მოძახილის ხმებს იმეორებს:
- 5 არქეტიპული სპექტრალური ხმა: Roger (Ancient Architect), Sarah (Soft Echo), Laura (Ethereal Narrator), Charlie (Elder Storyteller) და Aria (Spectral Whisper).
- ერთი დაწკაპუნებით MP3 ექსპორტი: ცოცხალ დეველოპერებს შეუძლიათ დააწკაპუნონ "⬇️ Download MP3"-ზე და სინთეზირებული მოჩვენების აუდიო პირდაპირ დისკზე ჩამოტვირთონ.
- 🎧 ნამდვილი არხით გადაცემული ჩანაწერი: მოუსმინეთ Thadeus Burgess-ის მოჩვენებას, რომელიც
Makefile-ს განმარტავს.
5. GitHub Copilot-ის ღრმა ინტეგრაცია და GitHub Actions ავტომატიზაცია
რეპოზიტორიაში ნატიურად ჩავაშენე სრული Copilot და GitHub Actions ავტომატიზაცია:
-
.github/copilot-instructions.md: რეპოზიტორიის მორგებული ინსტრუქციები, რომლებიც განმარტავს 4-აგენტიან ნეკრომანტიის არქიტექტურას, TabPFN 7D სქემასა და Pydantic მოდელებს. -
.github/prompts/: 3 მრავალჯერ გამოსაყენებელი IDE prompt შაბლონი (/resurrect-file,/tabpfn-mortality,/dep-modernize). -
.github/workflows/ci.yml: მრავალოპერაციულსისტემური CI ტესტირების მატრიცა Ubuntu-სა და Windows-ზე, 25 unit და ინტეგრაციული ტესტის წარმატებით გავლით. -
.github/workflows/cd.yml: Continuous Deployment pipeline, რომელიც ამოწმებს ცოცხალი პროდაქშენის ჯანმრთელობას (/health), ამოწმებს SVG ბეჯებს და ქმნის დაფორმატებულ Markdown შეჯამებებს. -
.github/workflows/copilot-review.yml: ავტომატური GitHub Action, რომელიც ამოწმებს კონტრიბუტორების PR-ებს შიშის კომენტარებზე (hack,do not touch) და აქვეყნებს ავტომატურ შემოწმების სიას.
6. რა გატყდა გზად (ინჟინერიული ნაწიბურები)
GitSéance-ის აშენება გლუვად არ წარმართულა. აქ არის სამი რეალური ინჟინერიული სიძნელე, რომლებსაც გავუმკლავდი:
1. მოჩვენება, რომელიც ზედმეტად ფიქრობდა (Gemma-ს აზროვნების ტოკენები)
როცა პირველად დავუკავშირდი gemma-4-26b-a4b-it-ს, ჩემი API გამოძახებები ხშირად ცარიელ ტექსტს აბრუნებდა. ნედლი პასუხის ობიექტის შესწავლით აღმოვაჩინე, რომ Gemma-ს მსჯელობის რეჟიმი ვრცელ შიდა აზროვნების კვალს წარმოქმნიდა (part.thought = True), რომელიც საბოლოო ტექსტის გამოტანამდე ტოკენების ბიუჯეტს ამოწურავდა. სტანდარტული SDK-ს წვდომები, როგორიცაა response.text, აზროვნების ბლოკების არსებობისას None-ს აბრუნებდა. დამიწია ქვედა დონის AST ამომღები დაწერა, რომელიც response.candidates[0].content.parts-ს გაივლის და გაუფილტრავ დიალოგს გამოყოფს.
2. GitHub REST API-ის blame-ის სიხშირის ლიმიტები
- პარალელური დაყოფა (
asyncio.gatherშეზღუდული batch-ის ზომით 8). - AST-ით სკანირებადი გაფართოების ფილტრები (SVG-ების, ბინარული ფაილებისა და lockfile-ების გამოტოვება).
- დეტერმინისტული ფორენზიკული სარეზერვო სნეპშოტები ისტორიული სასაფლაოებისთვის (
flask-cache,jquery-color), რათა აპლიკაცია არასდროს გაწყდეს, მაშინაც კი, თუ მომხმარებელს GitHub PAT არ აქვს.
3. Python 3.11-ის უკუხაზის შეზღუდვები SSE სტრიმინგში
Server-Sent Events (SSE) რეალურ დროში იმპლემენტაციისას Python 3.11-მა მოულოდნელად გამოსცა SyntaxError: f-string expression part cannot include a backslash, როცა JSON მონაცემთა payload-ებს ჩასმულად ფორმატირებდა. მომიწია სტრიმინგის გენერატორის რეფაქტორინგი, რათა შეტყობინებები ფორმატირებამდე ექსპლიციტურ შუალედურ buffer-ებში სერიალიზებულიყო data: {msg}\n\n-ისთვის.
რატომ აქვს მნიშვნელობა ღია ინოვაციას?
"რა გახადა შესაძლებელი ღია ინოვაციამ, რაც დახურულმა API-მ ვერ შეძლებდა?"
GitSéance-ის აშენებამ გამოკვეთა, რატომ არის ღია წონის მოდელები და ღია AI ინფრასტრუქტურა სასიცოცხლოდ მნიშვნელოვანი:
ჰაერგაუმტარი კოდის კონფიდენციალურობა და ნულოვანი IP გაჟონვა:
კომერციულ კოდბაზებში არის კონფიდენციალური ბიზნეს ლოგიკა, უსაფრთხოების მონაცემები და სავაჭრო საიდუმლოებები. ორგანიზაციებს არ შეუძლიათ მთელი git ხეების დახურულ მესამე მხარის cloud API-ებში ჩასმა. იმის გამო, რომ Gemma და TabPFN-3.5 ღია წონის მოდელებია, GitSéance სრულად შეუძლია იმუშაოს ოფლაინ, ჰაერგაუმტარ მანქანაზე. თქვენი კოდი არასდროს ტოვებს თქვენს ლოკალურ ტექნიკას.აუდიტირებადი, რეპროდუცირებადი რისკის მოდელირება:
როცა ალგორითმი აცხადებს, რომ კრიტიკულ საბანკო მოდულს „98% სიკვდილიანობის რისკი“ აქვს, დეველოპერებს ეკუთვნით იმის გაგება, რატომ. დახურული საკუთრებითი შეფასების სისტემები შავი ყუთებია, რომლებიც მოდელის ვერსიებს შორის უხმოდ იცვლება. TabPFN-ის ბაიესური foundation მოდელი იძლევა დეტერმინისტულ, რეპროდუცირებად ცხრილურ დასკვნას, რომლის შემოწმება, შედარება და ნდობა შეიძლება.მდგრადობა API-ის მოძველებისადმი:
დახურული AI სერვისები ხშირად წყვეტენ endpoint-ების მუშაობას, ცვლიან სისტემურ პრომპტებს ან ზრდიან ტოკენების ღირებულებას. ღია წონის AI-ით თქვენი ნეკრომანტი ინტერნეტის გამორთვის შემდეგაც იმუშავებს. თუ ელექტრო ენერგია გაითიშა, მოჩვენებები ხელმისაწვდომი რჩება.საზოგადოებრივი fine-tuning და მორგებული პერსონები:
ღია წონები საშუალებას აძლევს გუნდებს, Gemma დააზუსტონ საკუთარ შიდა commit-ის ისტორიებზე, Jira ბილეთებსა და არქიტექტურულ გადაწყვეტილებების ჩანაწერებზე (ADR), რაც კომპანიის ყოფილ თანამშრომლებს მუდმივ institutional მეხსიერებად აქცევს.
მისი სული
პროგრამული უზრუნველყოფის ინჟინერიას აქვს ჩუმი ტრაგედია: დეველოპერები თვეების განმავლობაში ათავსებენ ცხოვრებას ელეგანტურ სისტემებში, მაგრამ ტექნოლოგიები იმდენად სწრაფად ვითარდება, რომ რამდენიმე წელიწადში მათ ნამუშევარს „legacy“ ეწოდება და გადაგდებულია.
Día de los Muertos-ის ტრადიციით, გარდაცვლილები სინამდვილეში არასდროს იკარგებიან, სანამ ისინი გახსოვთ. როცა GitSéance მიტოვებული, ათწლიანი ფაილის ავტორს არხით გადასცემს, ის კოდს არ დასცინის იმის გამო, რომ მოძველდა. ის იმ დეველოპერს ხმას აძლევს, რომ თქვას:
"ეს კოდი მაშინ დავწერე, როცა მეხსიერება ცოტა იყო და ვადები მჭიდრო. ის თავის დანიშნულებას ასრულებდა. ახლა აქ არის, როგორ შეგიძლიათ ფაკელი გადასცეთ შემდეგ თაობას."
ეს პერსპექტივის ცვლილება — ძველი კოდის შიშიდან იმ ადამიანური ძალისხმევის პატივისცემამდე, რომელიც მის უკან დგას — GitSéance-ის ჭეშმარიტი სულია.
პრიზის კატეგორიები
- 🏆 მთავარი პრიზი — Challenge-ის საერთო გამარჯვებული
- 🚀 Render-ის საუკეთესო გამოყენება — სრული სტეკის კონტეინერიზებული დეპლოიმენტი, რომელიც FastAPI ნეკრომანტიის ძრავასა და CRT ფრონტენდს ერთად უშვებს პროდაქშენში https://gitseance.onrender.com-ზე
render.yaml-ის მეშვეობით. - 📊 TabPFN-ის საუკეთესო გამოყენება (Prior Labs) — TabPFN-3.5 ცხრილური foundation მოდელი კალიბრირებული ბაიესური კოდის სიკვდილიანობის პროგნოზისთვის 7D feature vector-ზე, დაწყვილებული ნატიურ Model Context Protocol (MCP) სერვერთან (
backend/mcp_server.py) და ერთი დაწკაპუნებით ფორენზიკული CSV dataset ექსპორტიორით. - 🔮 Gemma-ს საუკეთესო გამოყენება — ღია წონის
gemma-4-26b-a4b-itმოდელი, რომელიც Medium აგენტს უძღვება დამყარებული ისტორიული პერსონის არხისთვის, აზროვნების ტოკენების დამუშავებისა და რეალურ დროში ინტერაქტიული სასაუბრო სეანსებისთვის. - 🤖 GitHub Copilot-ის საუკეთესო გამოყენება — მორგებული რეპოზიტორიის ინსტრუქციები (
.github/copilot-instructions.md), 3 მრავალჯერ გამოსაყენებელი IDE prompt შაბლონი (.github/prompts/), ავტომატური PR-შემმოწმებელი GitHub Action, რომელიც აუდიტს უკეთებს შიშის კომენტარებს (.github/workflows/copilot-review.yml), და მრავალოპერაციულსისტემური CI/CD ავტომატიზაცია. - 🔊 ElevenLabs-ის საუკეთესო გამოყენება — ნეირონული TTS მეტყველების სინთეზი, რომელიც გარდაცვლილ ავტორებს ხმას აძლევს 5 განსხვავებული სპექტრალური არქეტიპით, რეალურ დროში Web Audio API ტალღური ვიზუალიზატორითა და ერთი დაწკაპუნებით MP3 აუდიო ექსპორტით.
- 🔍 SerpApi-ის საუკეთესო გამოყენება — რეალურ დროში 2026 წლის დამოკიდებულებების ინტელექტი, მოძველებული პაკეტირებისთვის თანამედროვე ჩანაცვლებების აღმოჩენა და ცოცხალი უსაფრთხოების CVE აუდიტები.
შექმნილია ვნებით, კოფეინითა და ექტოპლაზმით — Dhruv Jani-ს მიერ.