Set up Idemcore for game and esports teamsCài đặt Idemcore cho đội game và esports
Idemcore makes the AI steps in your game, such as NPC decisions, bots and AI referees, give identical output on every supported device. Each step can be logged as a short hash per tick, so your server can replay a sample and a referee can settle a disputed match from the log.Idemcore giúp các bước AI trong game, như quyết định của NPC, bot hay trọng tài AI, cho kết quả giống hệt trên mọi thiết bị được hỗ trợ. Mỗi bước có thể ghi thành một hash ngắn theo từng tick, để server phát lại một phần mẫu và trọng tài xử lý trận đấu bị tranh chấp dựa trên log.
- OverviewTổng quan
- Choose a deploymentChọn cách triển khai
- RequirementsYêu cầu
- Determinism rulesQuy tắc tất định
- IntegrateTích hợp
- Receipts and verificationReceipt và kiểm chứng
- Security and dataBảo mật và dữ liệu
- Pilot stepsCác bước thí điểm
- Pricing and next stepsGiá và bước tiếp theo
1. OverviewTổng quan
Idemcore makes the AI steps in your game, such as NPC decisions, bots and AI referees, give identical output on every supported device. Each step can be logged as a short hash per tick, so your server can replay a sample and a referee can settle a disputed match from the log.Idemcore giúp các bước AI trong game, như quyết định của NPC, bot hay trọng tài AI, cho kết quả giống hệt trên mọi thiết bị được hỗ trợ. Mỗi bước có thể ghi thành một hash ngắn theo từng tick, để server phát lại một phần mẫu và trọng tài xử lý trận đấu bị tranh chấp dựa trên log.
What ships today: the cloud API, the Python and JavaScript SDKs and the open verifier. On-premises deployments run through a pilot and a license; anything else on this page is marked early access or coming soon.Những gì có ngay hôm nay: API cloud, SDK Python và JavaScript, và công cụ kiểm chứng mở. Triển khai tại chỗ đi qua thí điểm và giấy phép; mọi thứ khác trên trang này đều ghi rõ truy cập sớm hoặc sắp ra mắt.
2. Choose a deploymentChọn cách triển khai
| OptionLựa chọn | StatusTrạng thái | NotesGhi chú |
|---|---|---|
| Cloud APIAPI cloud | Available nowCó ngay | Self-serve today. Good for prototypes, server-side AI steps and trying the receipts.Tự đăng ký ngay hôm nay. Phù hợp để làm thử, chạy bước AI phía server và thử receipt. |
| Your game servers (on-premises)Server game của bạn (tại chỗ) | Through a pilotQua thí điểm | The engine runs on your servers under a license. Starts with a pilot.Engine chạy trên server của bạn theo giấy phép. Bắt đầu bằng thí điểm. |
| On-device SDKSDK trên thiết bị | Early accessTruy cập sớm | Runs on players’ devices. Join the waitlist.Chạy trên thiết bị của người chơi. Đăng ký danh sách chờ. |
3. RequirementsYêu cầu
- Hardware measured so far: x86-64 CPUs; ARM CPUs on an Android phone (Galaxy Z Fold5) and a Windows 11 ARM64 laptop; NVIDIA T4, A10, A10G, L40S and H100 GPUs. AMD and Apple GPUs are not supported yet.Phần cứng đã đo: CPU x86-64; CPU ARM trên điện thoại Android (Galaxy Z Fold5) và laptop Windows 11 ARM64; GPU NVIDIA T4, A10, A10G, L40S và H100. GPU AMD và Apple chưa được hỗ trợ.
- Models today: Qwen2.5-0.5B and Qwen2.5-7B (8-bit and 4-bit), gpt-oss-20b and gpt-oss-120b.
GET /v1/modelslists what the cloud API serves. Other models are scoped in a pilot.Model hiện có: Qwen2.5-0.5B và Qwen2.5-7B (8 bit và 4 bit), gpt-oss-20b và gpt-oss-120b.GET /v1/modelsliệt kê model mà API cloud đang phục vụ. Model khác được xác định trong thí điểm. - Cloud API: HTTPS access to
api.idemcore.net, Python 3.9+ or Node 18+ for the SDKs, called from your server.API cloud: truy cập HTTPS tớiapi.idemcore.net, Python 3.9+ hoặc Node 18+ cho SDK, gọi từ server của bạn. - On-premises: operating system, memory and GPU sizing are agreed for your model during the pilot. It can run without internet access.Tại chỗ: hệ điều hành, bộ nhớ và cấu hình GPU được thống nhất theo model của bạn trong thí điểm. Có thể chạy không cần internet.
4. Determinism rulesQuy tắc tất định
- Greedy decoding: omit
temperatureor send 0, and keepnat 1.Giải mã greedy: bỏtemperaturehoặc gửi 0, và giữnbằng 1. - Pin the model id and the engine build. Every receipt records both, so you can see what produced an answer.Ghim mã model và bản engine. Mọi receipt đều ghi cả hai, nên bạn biết câu trả lời được tạo ra từ đâu.
- Send byte-identical input: the same messages, in the same order, with the same text encoding.Gửi đầu vào giống từng byte: cùng các message, cùng thứ tự, cùng cách mã hoá văn bản.
- Idemcore makes the AI step deterministic, not your whole game. Physics, timers, threads and networking stay your responsibility.Idemcore làm cho bước AI tất định, không phải toàn bộ game. Vật lý, bộ đếm thời gian, luồng và mạng vẫn do bạn đảm bảo.
5. IntegrateTích hợp
pip install idemcore export IDEMCORE_API_KEY="ick_…" # create it in the console
- Call the AI step once per tick with the same inputs on every machine: serialise the game state the same way, byte for byte.Gọi bước AI mỗi tick một lần với cùng đầu vào trên mọi máy: tuần tự hoá trạng thái game theo cùng một cách, giống từng byte.
- Write the tick hash (or the receipt id) into the match log next to your own game events.Ghi tick hash (hoặc mã receipt) vào log trận đấu, cạnh các sự kiện game của bạn.
- On the server, replay a sample of ticks and compare hashes. A mismatch flags the match for review.Trên server, phát lại một phần tick mẫu và so hash. Nếu lệch, trận đấu được đánh dấu để rà soát.
- In a dispute, export the log. The referee re-runs it with the open verifier and sees the first tick that differs.Khi tranh chấp, xuất log. Trọng tài chạy lại bằng công cụ kiểm chứng mở và thấy tick đầu tiên bị lệch.
from idemcore import Idemcore
client = Idemcore() # reads IDEMCORE_API_KEY
MODEL = client.models()[0]["id"] # pin one model id for the whole match
def npc_step(tick, state_text):
# state_text must be serialised the same way, byte for byte, on every machine
r = client.chat(state_text, model=MODEL, max_tokens=32)
match_log.append({"tick": tick, "receipt_id": r.receipt_id})
return r.textEngine integration (a C API, or a Unity or Unreal plugin) is defined with you during the pilot; we do not promise dates yet. Idemcore sits next to your anti-cheat: it does not detect wallhacks or aimbots.Cách tích hợp vào engine (C API, hoặc plugin Unity hay Unreal) được xác định cùng bạn trong thí điểm; chúng tôi chưa hứa ngày cụ thể. Idemcore đặt cạnh anti-cheat của bạn: nó không phát hiện wallhack hay aimbot.
6. Receipts and verificationReceipt và kiểm chứng
A receipt is a small signed JSON object. It records the model, the engine build, salted hashes of the input and output and a digest of the run’s hash log. It contains no prompt or answer text, so it is safe to store or forward.Receipt là một đối tượng JSON nhỏ có chữ ký. Nó ghi model, bản engine, hash có salt của đầu vào và đầu ra, cùng digest của log hash của lần chạy. Nó không chứa prompt hay nội dung câu trả lời, nên có thể lưu hoặc chuyển tiếp an toàn.
- Check it with the SDK (
verify_local), the open verifier, orPOST /v1/receipts/verify. Public signing keys:GET /v1/keys.Kiểm bằng SDK (verify_local), công cụ kiểm chứng mở, hoặcPOST /v1/receipts/verify. Khóa công khai:GET /v1/keys. - On-premises deployments sign receipts with a key you generate and hold.Triển khai tại chỗ ký receipt bằng khóa do bạn tạo và giữ.
pip install idemcore-verify idemcore-verify check answer.log idemcore-verify compare answer.log your_rerun.log
Receipt format and verification levels →Định dạng receipt và các mức kiểm chứng →
7. Security and dataBảo mật và dữ liệu
- Cloud API: hash-only by default. We store the receipt, the hash log and audit events, never the prompt or answer text; storing full text is an opt-in setting.API cloud: mặc định chỉ lưu hash. Chúng tôi lưu receipt, log hash và sự kiện kiểm toán, không bao giờ lưu prompt hay nội dung câu trả lời; lưu toàn văn là tùy chọn bạn phải bật.
- On-premises: prompts, answers and logs stay in your infrastructure.Tại chỗ: prompt, câu trả lời và log ở lại trong hạ tầng của bạn.
- API keys are shown once and stored only as a hash. If a key leaks, create a new one and write to [email protected] to revoke the old one.API key chỉ hiện một lần và chỉ được lưu dưới dạng hash. Nếu key bị lộ, hãy tạo key mới và viết cho [email protected] để thu hồi key cũ.
- Report vulnerabilities to [email protected]. An SBOM and a data processing agreement come with the contract.Báo lỗ hổng tới [email protected]. SBOM và thỏa thuận xử lý dữ liệu được cung cấp kèm hợp đồng.
8. Pilot stepsCác bước thí điểm
How pilots work.Thí điểm diễn ra thế nào. Every license starts with a fixed-scope pilot of about 10 weeks: scope (week 1), integrate (weeks 2–6), measure against pass criteria agreed up front (weeks 6–10), then decide. Pilots run on your hardware or our shared cloud; a dedicated cloud GPU is quoted separately.Mọi giấy phép đều bắt đầu bằng thí điểm phạm vi cố định khoảng 10 tuần: xác định phạm vi (tuần 1), tích hợp (tuần 2–6), đo theo tiêu chí đạt thống nhất từ đầu (tuần 6–10), rồi quyết định. Thí điểm chạy trên phần cứng của bạn hoặc cloud dùng chung của chúng tôi; GPU cloud riêng được báo giá riêng.
If you sign a license within 60 days of the pilot, the pilot fee is credited to the first year. Licenses run on your infrastructure; any use of the Idemcore cloud API follows the published cloud prices.Nếu ký giấy phép trong vòng 60 ngày sau thí điểm, phí thí điểm được trừ vào năm đầu tiên. Giấy phép chạy trên hạ tầng của bạn; mọi lần dùng API cloud của Idemcore tính theo giá cloud đã công bố.
Bring to the first call:Chuẩn bị cho buổi đầu tiên:
- The model (or models) you want to runModel bạn muốn chạy
- Two or more of your target devices or platformsTừ hai thiết bị hoặc nền tảng đích của bạn trở lên
- Your engine and a tick budgetEngine bạn dùng và ngân sách thời gian cho mỗi tick
- Pass criteria, for example identical hashes on all devices within the tick budgetTiêu chí đạt, ví dụ hash giống nhau trên mọi thiết bị trong ngân sách tick
- One technical contactMột đầu mối kỹ thuật
9. Pricing and next stepsGiá và bước tiếp theo
Pilot $15K–50K. Indie studios (under $1M annual revenue and under 100K MAU) get a free runtime license when the SDK ships.Thí điểm $15K–50K. Studio indie (doanh thu dưới $1 triệu/năm và dưới 100K MAU) được giấy phép runtime miễn phí khi SDK phát hành. Plans →Các gói → · All prices →Toàn bộ bảng giá →
Questions: Câu hỏi: [email protected] for pilots and licensescho thí điểm và giấy phép, [email protected] for API helpcho hỗ trợ API.