Installation
Server SDK Installation
Install and initialise the Node.js server SDK.
Node.js
npm install pingerchips-js-serverNode ≥ 18 (the SDK uses native fetch). ESM only — add "type": "module" to
package.json or use .mjs.
import PingerchipsServer from 'pingerchips-js-server';
const pc = new PingerchipsServer(
process.env.PINGERCHIPS_APP_KEY,
process.env.PINGERCHIPS_APP_SECRET,
);
// endpoint defaults to https://queue.pingerchips.com (prod)
await pc.trigger('my-channel', 'my-event', { message: 'Hello from server!' });The package also exports PingerchipsServerChat (chat REST) and, at the subpath
pingerchips-js-server/agent-session.js, AgentSession for chat agents.
Python
The pingerchips Python package is an agent SDK only — AgentSession,
Run, Invocation for driving chat threads.
It has no trigger, channel auth, or push. For those from Python, call the
HTTP API directly.
pip install pingerchipsPython ≥ 3.10.
from pingerchips import AgentSession
agent = AgentSession(
os.environ["PINGERCHIPS_APP_KEY"],
os.environ["PINGERCHIPS_APP_SECRET"],
)
thread = await agent.connect(thread_id, "my-bot")Environment variables
PINGERCHIPS_APP_KEY=your-app-key
PINGERCHIPS_APP_SECRET=your-app-secretNever commit the App Secret.
Next steps
- Server SDK Reference — trigger, auth, push, chat, mTLS
- Durable Objects Server SDK
- Authentication — header auth and capability tokens