Kanysh Basic · MCP-копилот · жергілікті

Kanysh Basic.
Модель
бойынша есеп —
чаттан.

Геологиялық модельдер бойынша есептеулерге арналған AI-копилот, Petrel және RMS-пен қатар жұмыс істейді. Экспортталған модельді ашып, сценарийлерді есептеп, нәтижелерді кез келген MCP-клиентте қарапайым сөйлемдермен тексеріңіз. Claude Desktop пен Claude Code-та қазірдің өзінде жұмыс істейді. Модельдер мен есептеулер жұмыс станцияңызда қалады.

v 0.2.0-dev6· macOS · Windows · Linux· Apache-2.0· тегін
3D-сахнаны ашу →
Norne · phi · 44 927 active · Statoil / OPM · ODbL-1.0
Модельдер мен есептер — өз станцияңызда· Petrel және RMS-пен қатар жұмыс істейді· Әр нәтиже — тәуелсіз тексерумен· GitHub-тағы ашық код · Apache-2.0

Сандарды тілдік модель емес, код есептейді.
Болжамдарды сіз растайсыз.

Kanysh Basic қағидасы
§ 01 / Концепция

Petrel-ді алмастырмайды.
Қасындағы
екінші пилот.

Модель әдеттегідей құрастырылады. Kanysh Basic экспортталған файлдарды — DATA/GRDECL, беттер, ұңғымалар, LAS — алып, әдетте Excel мен қолмен тексеруге кететін жұмысты атқарады: аймақтар бойынша көлемдер, сценарийлер, салыстыру және QC. Басқару біреу — әңгіме.

Тапсырма
Қолмен · Petrel + Excel
Kanysh Basic
Есептеуді іске қосу
Мәзірде процесті баптау, параметрлерді қойындылар арасында көшіру
Чатта бір сөйлем. Агент құралды өзі таңдайды.
Болжамдар
Жоба баптауларында және басқа Excel файлдарында жасырылған
Файл мен жол көрсетілген ұсыныстар. Сіз растамайынша есеп басталмайды.
Тексеру
«Көзбен» немесе екінші әдіспен қолмен қайта есептеу
Әр нәтиженің тәуелсіз тексерісі: PASS / FAIL / NOT RUN.
Тарих
Жоба қайта жазылады, нұсқалар жоғалады
Кірістер мен нәтижелердің өзгермейтін ревизиялары.
Салыстыру
Petrel және RMS кестелерін қолмен салыстыру
CSV-мен салыстыру және айырмашылық себептерін түсіндіру.
Есеп
Скриншоттар және қолмен рәсімдеу
HTML, Excel, PDF — болжамдар мен статустарымен.
Тіл
English
MCP-клиентіңіздің кез келген тілі.
§ 02 / Сценарийлер

Бір сөйлем —
бір есеп.

Бес негізгі сценарий — дайын MCP prompt-тары, сонымен қатар үлкен модельдер және деккіңізді OPM Flow-да іске қосу. Құрал атауларын жаттаудың қажеті жоқ: тапсырманы өз сөзіңізбен сипаттаңыз, агент құралды таңдап, жетіспейтінін сұрайды.

check_model

Модельді тексеру

«Модельді тексеріп, мәселелерді severity және IJK-мен көрсет»

  • DATA/GRDECL, INCLUDE, BOX/EQUALS/COPY импорты
  • азғындалған және бұралған ұяшықтар
  • табылған қателер үнсіз түзетілмейді

regional_volumes

Аймақтар бойынша көлемдер

«Менің контактілеріммен EQLNUM бойынша мұнай мен бос газды есепте»

  • аймақтар бойынша STOIIP және GIIP
  • СМК/ГМК, Bo/Bg, қалдық қанығулар
  • биіктік бойынша Sw функциялары, полигондар

reconcile_petrel

Petrel/RMS-пен салыстыру

«Көлемдерді Petrel CSV-імен салыстырып, айырмашылықтарды түсіндір»

  • метрикалар мен бірліктерді анық сәйкестендіру
  • ықтимал себептер дәлелденгендерден бөлек
  • кіріс деректері өзгермейді

tornado_analysis

Сезімталдық

«Екі аймақ үшін кеуектілік бойынша торнадо құр»

  • сіз берген диапазондар бойынша торнадо
  • seed-пен корреляцияланған Монте-Карло
  • сәтсіз іске қосулар қайта таңдалмайды

compare_versions

Ревизияларды салыстыру

«Модельдің екі нұсқасын және кеуек көлеміне әсерін салыстыр»

  • бірдей IJK кезінде өзгерген ұяшықтар
  • аймақтар бойынша әсер
  • LAS бойынша ұңғымалар vs модель

экспорт

Есептер және 3D

«Есепті Excel және PDF-ке шығарып, модельді 3D-да көрсет»

  • HTML, JSON, CSV, PNG, Excel, PDF
  • браузердегі офлайн 3D-сахна
  • ISSUES / NOT RUN статустары сақталады

eclipse_import

Үлкен модельдер

«EGRID пен INIT-ті импорттап, модельді тексер»

  • ASCII DATA және бинарлы EGRID/INIT ағынды импорты
  • 200 млн ұяшықта тексерілді
  • GPU нұсқасы: CUDA-дағы көлемдер CPU-мен салыстырылады

simulation_deck_run

OPM Flow-дағы гидродинамика

«Менің декімді OPM Flow-да іске қосып, ECLIPSE-пен салыстыр»

  • сіздің .DATA және INCLUDE — сол күйінде, өзгеріссіз
  • Linux немесе Windows WSL2 арқылы
  • SMSPEC жиынтығы → Parquet, эталонмен салыстыру
§ 03 / Қалай жұмыс істейді

Агент сұрайды. Сіз растайсыз. Код есептейді.

MCP-клиентіңіздегі LLM тапсырманы түсініп, Kanysh Basic-тің типтелген құралдарын шақырады. Сандарды машинаңыздың CPU-ында тексерілген Python-код есептейді, ал нәтиже тәуелсіз әдіспен тексеріледі.

  • 01 — БумаЭкспорт бумасын қосасыз. Kanysh тек сіз рұқсат еткенді көреді.
  • 02 — Талдауfolder_assess файлдардың рөлдерін анықтап, контактілер, PVT және бірліктерді ұсынады — файл мен жолы көрсетіліп.
  • 03 — РастауБолжамдарды растайсыз немесе түзетесіз. Жетіспейтін тұрақтылар қойылмайды.
  • 04 — ЕсептеуЖурналы бар тапсырма; кірістер мен нәтижелер өзгермейтін ревизия ретінде сақталады.
  • 05 — ЕсепТәуелсіз тексерулер, PASS / ISSUES / NOT RUN статустары, Excel және PDF экспорты.
Norne · MCP арқылы нақты іске қосу# Геолог: "EQLNUM 1 және 3 бойынша мұнай мен газды есепте. СМК −2692 / −2618 м, ГМК −2582 м, Bo 1.2, Bg 0.005, Sw 0.25 — растаймын" # Агент: folder_assess(source="norne") ↳ EQUIL: E3.prop, 18, 20 жолдар — ұсыныс eclipse_import(...) ↳ 113 344 ұяшық · 44 927 белсенді model_qc(...) ↳ ISSUES · 243 азғындалған, 1 бұралған regional_volumes(regions=[1, 3], ...) # Жауап: EQLNUM 1 STOIIP 9 347 774 ст. м³ EQLNUM 3 STOIIP 2 860 856 ст. м³ Барлығы STOIIP 12 208 630 ст. м³ GIIP 6,197 млрд ст. м³ тәуелсіз тексеру: PASS
§ 04 / Архитектура

Әңгіме — клиентіңізде.
Есеп — машинаңызда.

Kanysh Basic — жергілікті MCP-сервер және офлайн-қарау құралы. Онда кірістірілген LLM де, бұлт та жоқ. AI-провайдерге қандай хабарлар жіберілетінін MCP-клиентіңіз шешеді.

Диалог

MCP-клиент
  • Claude Desktop, Claude Code — қазір дайын
  • Codex, Cursor және басқалары — stdio арқылы
  • ChatGPT — Secure MCP Tunnel арқылы, жоспарда
  • AI-провайдерді және оған не жіберілетінін сіз таңдайсыз

Kanysh Basic

Жергілікті MCP-сервер
  • Python 3.12 · ресми MCP SDK
  • Типтелген құралдар және ұзақ тапсырмалар
  • Өзгермейтін ревизиялар және тапсырмалар журналы
  • Тәуелсіз сандық тексерулер
  • CPU процесс пулдары · қажет болса CUDA
  • Офлайн-қарау құралы · REST API · CLI

Деректер

Сіздің экспорттарыңыз
  • Eclipse DATA / GRDECL · EGRID / INIT · .GRID
  • IRAP, ZMAP+, CPS-3 беттері
  • RMS ұңғымалары; Petrel ASCII траекториялары, белгілері мен полигондары
  • LAS · CSV · ROFF
  • Poststack SEG-Y → Zarr тайлдары
ГЕОЛОГ  ⟶  MCP-КЛИЕНТ  ⟶  KANYSH BASIC  ⟶  СІЗДІҢ ФАЙЛДАР  ⟶  ТЕКСЕРІЛГЕН ЕСЕП
§ 05 / Демо

Norne: ашық деректер,
нақты есеп.

Norne кен орнының жария моделі (Statoil / OPM): 113 344 ұяшық, 44 927 белсенді. Буманы талдаудан PDF-ке дейінгі бүкіл жол нақты MCP арқылы өтті. Флюид параметрлері — қор бағасы емес, анық демо-болжамдар.

Norne porosity, 3D scene
Кеуектілік · барлық 44 927 белсенді ұяшық
EQLNUM 1 және 3 аймақтары бойынша көлемдер
EQLNUM Ұяшық СМК, м STOIIP, ст. м³ GIIP, млн ст. м³
14 22426929 347 7745 375
31 29626182 860 856822
Барлығы5 520—12 208 6306 197
STOIIP торнадосы · кеуектілік ×0,9–1,1
EQLNUM 111.27 – 13.14
EQLNUM 311.92 – 12.49
база 12,21 млн ст. м³

Модель QC: ISSUES — 243 азғындалған және 1 бұралған ұяшық. Олар жасырын жойылмайды: көлемдер QC-ке сәйкес 1 және 3 аймақтар үшін есептелді. Демо-болжамдар: Bo 1,2, Bg 0,005, Sw 0,25. Norne деректері: Statoil / OPM, ODbL-1.0 / DbCL-1.0.

§ 06 / Ауқым

Norne-дан 200 млн ұяшыққа дейін.
Және нақты Volve деректері.

Kanysh Basic-ті тек демода ғана тексермейміз. 200 млн ұяшықты синтетикалық corner-point модель кәдімгі ноутбукта толық жолдан өтеді, ал нақты Equinor Volve моделі ECLIPSE-пен қай жерде сәйкес келетінімізді және қай жерде әлі олқылықтар бар екенін көрсетті.

200 млн ұяшық · синтетика
Кезең Уақыт RAM шыңы
DATA/COORD/ZCORN импорты17,7 мин12,1 GiB
Модель QC12,3 мин2,6 GiB
Аймақтар бойынша көлемдер14,6 мин2,1 GiB
Торнадо13,8 мин2,1 GiB

Ноутбук: 16 ағын, 64 ГБ RAM, Windows 11, CPU-да есептеу. Бір іске қосу; барлық тексерулер PASS, әдейі бүлдірілген үш ұяшық анық алып тасталды. Әдістеме және бастапқы деректер.

Equinor Volve · нақты деректер
  • 680 400 ұяшық, 183 545 белсенді — MINPV/PINCH-тен кейінгі ECLIPSE-пен дәл бірдей
  • Кеуек көлемі ECLIPSE PORV-пен: дек көбейткіштерін ескергенде медианалық айырма 3,4·10⁻⁵
  • OPM Flow-дағы дек: 2016 жылға дейін 339 есеп қадамы, 35 мин. Бастапқы қорлар сәйкес, қысым — 0,46 % шегінде, жинақталған өндіру — 0,9 %
  • Парсер олқылықтары табылып, түзетілді: MAXVALUE/MINVALUE, MULTIREG. ADDZCORN әзірге қолдау көрсетілмейді, импорт анық бас тартады

Equinor Volve деректері (Equinor Open Data Licence) Kanysh-пен таратылмайды. OPM декті қабылдауы үшін онда 3 құжатталған түзету жасалды; ADDZCORN мен PRIORITY-ді OPM елемеді. Толық есеп.

§ 07 / Орнату

Бір файл.
Үш қадам.
Алғашқы сөз — «begin».

Claude Desktop үшін — бір басумен орнатылатын .mcpb кеңейтуі. Басқа MCP-клиенттер үшін сол архив кәдімгі stdio-сервер ретінде іске қосылады. Python тәуелділіктерін uv орнатады; архивте — код және Norne жария демосы, бөтен деректер жоқ.

01 · Жүктеу
.mcpb файлын жүктеңіз
Әдеттегі нұсқа — CPU, 14,0 МБ. NVIDIA бейнекарталары үшін бөлек GPU нұсқасы бар (CUDA 12.6, алғаш орнатқанда шамамен 2,5 ГБ жүктейді); екеуін қатар орнатуға болады. macOS, Linux және Windows — нативті, WSL-сіз; нақты Windows-қа орнату әлі тексерілуде: Windows нұсқаулығы.
↳ ~1 минут
02 · Орнату
Оны Claude Desktop-та ашыңыз
Клиент тәуелділіктерді орнатады — желі мен дискіде орын қажет. Нәтижелер бумасын және қаласаңыз экспортталған модель бумасын көрсетіңіз — оған тек оқуға рұқсат беріледі.
↳ Claude Desktop · бірнеше минут
03 · Бастау
«begin» prompt-ын таңдаңыз
Агент не істей алатынын айтады. Экспорт бумасын қосыңыз немесе Norne демосын ашыңыз — қайта есептеусіз сақталған нәтижелер.
↳ жұмыс істеуге болады
Басқа MCP-клиенттер

Codex, Cursor және басқалары

Репозиторийді клондап, uv арқылы тәуелділіктерді орнатыңыз (Python 3.12 қажет) және клиент конфигурациясына stdio-серверді жазыңыз (Windows-та жол — .venv\Scripts\kanysh-basic.exe). Git-сіз де болады: .mcpb файлы — кәдімгі zip, оны ашып, uv run --directory <бума> server.py іске қосу жеткілікті.

Браузер мен қосымшадағы ChatGPT тек HTTPS арқылы қашықтағы MCP-серверлерді қосады, жергілікті сервер оған қолжетімсіз. OpenAI Secure MCP Tunnel арқылы қосылу — жоспарда.

shellgit clone https://github.com/almukhanomr/kanysh && cd kanysh uv python install 3.12 uv sync --frozen --no-dev --extra ui --extra viewer --python 3.12 # Claude Desktop / Claude Code: uv run --no-sync kanysh-basic setup
JSON · Cursor, Claude Desktop қолмен және көптеген клиенттер{ "mcpServers": { "kanysh-basic": { "command": "/path/to/kanysh/.venv/bin/kanysh-basic", "args": ["--home", "/path/to/state", "mcp", "--profile", "agent"] } } }
Codex · ~/.codex/config.toml[mcp_servers.kanysh-basic] command = "/path/to/kanysh/.venv/bin/kanysh-basic" args = ["--home", "/path/to/state", "mcp", "--profile", "agent"] startup_timeout_sec = 120
Kanysh Basic · 0.2.0-dev6v0.2.0-dev6 release github.com/almukhanomr/kanysh · v0.2.0-dev6 ↗ manifest MCPB v0.4 · uv runtime · python >=3.12 <3.13 platform win32 · darwin · linux license Apache-2.0 cpu kanysh-basic-0.2.0-dev6.mcpb · 13 977 034 B sha256 1c52a8c8753cc74eaa7150719540e935554c0c411cf9aa00148456c5325f6a58 gpu kanysh-basic-gpu-0.2.0-dev6.mcpb · 13 983 348 B · CUDA 12.6 sha256 312b9107cafc1e1e736771a00eec5f1c2d6cce7186094470dd1042bbdc717b54 status ерте релиз · Claude Desktop және Claude Code — дайын; басқа MCP-клиенттер — stdio арқылы
§ 08 / Шектеулер

Basic не істемейтіні
туралы шынын айтсақ.

Сандық PASS геологиялық сараптаманы алмастырмайды. Қазіргі шектеулер мынадай.

§ 09 / Kanysh Advanced

Әрі қарай — әңгімемен
басқарылатын геологиялық
станция.

Kanysh Advanced — келесі қадам: браузердегі AI-нативті жұмыс станциясы, тапсырыс берушінің GPU-серверінде, OSDU үстінде. Сейсмика, ұңғымалар, модельдеу — агентпен диалог арқылы. Бұл уәде етілген мерзім емес, даму бағыты: Basic-те бұл функциялар жоқ.

Қазір
Basic
қабылданды · 0.2.0-dev6

Petrel/RMS-пен қатар MCP-копилот: импорт, QC, көлемдер, салыстыру, сезімталдық, есептер.

Advanced
Модельдеу
жоспарда

Бірнеше горизонт пен жарылымы бар құрылымдық модельдер, каротажды апскейлинг, фациялар және қасиеттерді кеңістіктік модельдеу, ұңғымалар корреляциясы.

Advanced
Ауқым және сервер
жоспарда

Үлкен ROFF, қашықтағы GPU-есептеулер, S3 және OSDU, үлкен сахналарды серверлік рендерлеу, сейсмиканы интерпретациялау.

Advanced
Динамика
жоспарда

Basic дайын декіңізді OPM Flow-да іске қосады. Әрі қарай: гидродинамикалық модель құру, тарихты бейімдеу (ES-MDA), ансамбльдер және игеру жоспарын оңтайландыру.

Kanysh Advanced интерфейсінің концепті
Kanysh
project: Tengiz-East  ·  OSDU: connected
● GPU · 71% VRAM · allocated geologist
⬡ ◈ ⌇ ▦ ≋ ⊞
inline 1247 · crossline 3204 tile · seismic/tengiz/1247.png z: t-domain · 0—5200 ms
Top Triassic · auto-tracked
SDMS stream CDP 4120 ────────────────── 4380 colormap: copper
Agent · LangGraph live
геолог
Теңіз бойынша inline 1247-ні көрсет және жоғарғы триасты созып шық.
→ osdu_get_seismic(survey="tengiz-east", inline=1247)
→ track_horizon(name="Top Triassic", method="seisnet")
kanysh
Кесінді салынды. Top Triassic аумақтың 92%-да созылды, сенімсіз аймақтар бөлектелген — CDP 4280 маңайын қара. Горизонтты OSDU-ға сақтайын ба?
геолог
Осы аралықта KZ-12 үшін Wyllie бойынша кеуектілікті есепте.
● _ ↵
Tengiz-East · OSDU · 4 wells · queue: 2 jobs online
§ 10 / Серіктестік

Пилоттар мен Advanced
серіктестерін іздейміз.

Basic жұмыс істейтін өзекті көрсетеді: әңгімеден тексерілетін есептеулер. Біз нақты модельдердегі пилоттарға, инвесторлармен және стратегиялық серіктестермен әңгімеге ашықпыз, әсіресе Petrel/RMS процестерін, OSDU мен мұнай-газ интерпретациясын білетіндермен.

Байланысу →
§ 11 / FAQ

Жиі қойылатын сұрақтар.

Қысқаша: бұл не, деректер қайда, іске қосу үшін не керек.

+Kanysh Basic деген не?
Бұл Petrel және RMS-пен қатар жұмыс істейтін геологиялық модельдер бойынша есептеулерге арналған AI-копилот. Техникалық тұрғыдан — офлайн-қарау құралы бар жергілікті MCP-сервер: сіз өз MCP-клиентіңізде (мысалы, Claude Desktop немесе Claude Code) сөйлесесіз, ал Kanysh Basic экспортталған модельдерді импорттап, көлемдер мен сценарийлерді есептеп, тәуелсіз тексерулері бар есептерді қайтарады.
+Ол Petrel немесе RMS-ті алмастыра ма?
Жоқ. Модельді әдеттегідей құрастырасыз. Kanysh Basic экспортталған файлдармен (DATA/GRDECL, EGRID/ROFF, беттер, ұңғымалар, LAS, CSV) жұмыс істеп, әдетте Excel-ге кететін есептеулер мен тексерулерді өз мойнына алады. Petrel және RMS нативті жоба базалары қолдау көрсетілмейді.
+Деректерім қайда жіберіледі?
Модельдер, есептеулер мен нәтижелер жұмыс станцияңызда қалады. Kanysh Basic-те бұлт та, кірістірілген LLM де жоқ. Диалог мәтіндері мен құрал нәтижелерін MCP-клиентіңіздің AI-провайдері көреді; оған нақты не жіберілетінін сіз және клиент баптаулары шешеді.
+ChatGPT-пен жұмыс істей ме?
Kanysh Basic — стандартты MCP-сервер, сондықтан жергілікті MCP-серверлерді іске қосатын клиенттермен жұмыс істейді: Claude Desktop, Claude Code, Codex, Cursor және басқалары. Браузер мен қосымшадағы ChatGPT тек HTTPS арқылы қашықтағы серверлерді қосады, станцияңыздың localhost-ы оған қолжетімсіз. OpenAI Secure MCP Tunnel арқылы қосылу — жоспарда; есептеулер бұл кезде станцияда қалады.
+AI сандарда қателесуі мүмкін бе?
Сандарды тілдік модель емес, детерминирленген Python-код есептейді, әр нәтиже тәуелсіз әдіспен тексеріледі. Файлдардан табылған параметрлер — тек файл мен жолға сілтемесі бар ұсыныстар: сіз растамайынша есеп іске қосылмайды, жетіспейтін тұрақтылар қойылмайды.
+Іске қосу үшін не керек?
Жергілікті серверлерді іске қосатын кез келген MCP-клиент. Ең оңайы — Claude Desktop (.mcpb кеңейтуі) немесе Claude Code: қазірдің өзінде дайын. Codex, Cursor және басқалары stdio арқылы қосылады. macOS, Linux немесе Windows және тәуелділіктерді алғаш орнату үшін желі жеткілікті. GPU міндетті емес: әдепкі есептеулер CPU-да, NVIDIA үшін бөлек GPU нұсқасы бар. Қалай орнату керек.
+Гидродинамиканы іске қосуға бола ма?
Иә, қосымша мүмкіндік ретінде. simulation_deck_run құралы дайын ECLIPSE декіңізді OPM Flow-да сол күйінде іске қосады: мәндерді генерацияламайды және қоймайды. Linux немесе WSL2 бар Windows қажет — kanysh-basic setup-opm OPM-ды бөлек дистрибутивке орнатып, SPE1-де тексереді. OPM бапталмаса, сұрау нұсқаулықпен бірге ашық бас тартады. Гидродинамикалық модель құру және тарихты бейімдеу — бұл Kanysh Advanced.
+Қанша тұрады?
Kanysh Basic тегін, Apache-2.0 лицензиясымен таратылады, бастапқы коды GitHub-та ашық. Сіздің модельдеріңіздегі пилот пен Kanysh Advanced-ты бөлек талқылаймыз: бізге жазыңыз.
+OSDU, сейсмика және GPU-сервер ше?
Бұл — Kanysh Advanced, келесі кезең: браузердегі AI-нативті жұмыс станциясы, тапсырыс берушінің GPU-серверінде, OSDU үстінде. Қазір бұл даму бағыты; Basic-те бұл функциялар жоқ. Толығырақ.
Kanysh Basic · v 0.2.0-dev6

.mcpb жүктеңіз.
«begin» деп жазыңыз.
Әрі қарай — есеп.