Set up Idemcore for simulation and replayCài đặt Idemcore cho mô phỏng và phát lại
Idemcore makes the AI steps inside your simulations and backtests replay identically, later and on other machines. Each call returns a signed receipt you store with the results, so a reviewer can check that a past result came from the stated model and input.Idemcore giúp các bước AI trong mô phỏng và backtest phát lại y hệt, về sau và trên máy khác. Mỗi lần gọi trả về một receipt có chữ ký để bạn lưu cùng kết quả, nhờ đó người rà soát kiểm được kết quả cũ đến từ đúng model và đầu vào đã nêu.
- 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 inside your simulations and backtests replay identically, later and on other machines. Each call returns a signed receipt you store with the results, so a reviewer can check that a past result came from the stated model and input.Idemcore giúp các bước AI trong mô phỏng và backtest phát lại y hệt, về sau và trên máy khác. Mỗi lần gọi trả về một receipt có chữ ký để bạn lưu cùng kết quả, nhờ đó người rà soát kiểm được kết quả cũ đến từ đúng model và đầu vào đã nêu.
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 evaluation, research runs and trying replay.Tự đăng ký ngay hôm nay. Phù hợp để đánh giá, chạy nghiên cứu và thử phát lại. |
| On-premises or air-gappedTại chỗ hoặc tách mạng | Through a pilotQua thí điểm | The engine runs on your workstations, cluster or offline network under a per-seat or annual license. Starts with a pilot.Engine chạy trên máy trạm, cụm máy hoặc mạng tách biệt của bạn theo giấy phép theo seat hoặc theo năm. Bắt đầu bằng thí điểm. |
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 simulator. Physics, random number generators and threading in your own code stay your responsibility.Idemcore làm cho bước AI tất định, không phải toàn bộ simulator. Vật lý, bộ sinh số ngẫu nhiên và luồng trong mã của bạn 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
- Wrap each AI step in your pipeline with an Idemcore call. Every call returns the answer and a receipt.Bọc mỗi bước AI trong pipeline bằng một lần gọi Idemcore. Mỗi lần gọi trả về câu trả lời và receipt.
- Store the receipt next to the run’s outputs, keyed by run and step.Lưu receipt cạnh đầu ra của lần chạy, theo mã lần chạy và bước.
- Replay with the same pinned model and engine build: on the cloud API with
POST /v1/receipts/replay, on-premises with the same licensed build.Phát lại với cùng model và bản engine đã ghim: trên API cloud bằngPOST /v1/receipts/replay, tại chỗ bằng cùng bản được cấp phép. - Auditors run the open verifier on the stored logs and get MATCH or the first position that differs.Kiểm toán viên chạy công cụ kiểm chứng mở trên log đã lưu và nhận MATCH hoặc vị trí đầu tiên bị lệch.
from idemcore import Idemcore
client = Idemcore() # reads IDEMCORE_API_KEY
MODEL = "MODEL_ID" # pin it in your run config
def ai_step(run_id, step, prompt):
r = client.chat(prompt, model=MODEL, max_tokens=256)
save_alongside_results(run_id, step, receipt_id=r.receipt_id) # your storage
return r.textLong runs: keep the model id, the engine build and your own simulator version together in the run config, so a replay years later uses the same versions.Với lần chạy dài: giữ mã model, bản engine và phiên bản simulator của bạn cùng nhau trong cấu hình chạy, để phát lại nhiều năm sau vẫn dùng đúng các phiên bản đó.
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:
- One scenario and the model you want to runMột kịch bản và model bạn muốn chạy
- Two or more of your machines or environmentsTừ hai máy hoặc môi trường của bạn trở lên
- Pass criteria, for example identical replays across machines and over timeTiêu chí đạt, ví dụ phát lại giống hệt giữa các máy và theo thời gian
- One technical contact, plus the reviewer who will check the resultsMột đầu mối kỹ thuật, và người sẽ rà soát kết quả
9. Pricing and next stepsGiá và bước tiếp theo
Pilot $15K–50K. Per seat $5K–15K per named user per year (minimum 3), or an annual license from $50K that includes up to 8 production GPUs.Thí điểm $15K–50K. Theo seat $5K–15K mỗi người dùng có tên mỗi năm (tối thiểu 3), hoặc giấy phép năm từ $50K gồm tối đa 8 GPU sản xuất. 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.