beam-master

Provides shared scripts and references for Beam AI API integration skills.

Updated Jan 22, 2026
One-click install
npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill beam-master-fahadimdad
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: beam-master
Source: https://github.com/FahadImdad/Nexus-Fahad/tree/main/00-system/skills/beam/beam-master
Command: npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill beam-master-fahadimdad

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) and references (resource) components.

What problem does it solve? Beam AI integration skills would otherwise duplicate setup instructions, API documentation, authentication flows, and error handling across every skill, wasting context and creating maintenance drift. ## Core Features & Use Cases - Shared Script Library: 27 Python scripts covering authentication, agent management, graph operations, task execution, HITL feedback, and analytics for the Beam AI API. - Shared References: Setup guide, full API reference for 22 endpoints, authentication flow, and error-handling documentation loaded on demand. - Intelligent Config Detection: check_beam_config.py outputs structured JSON with an ai_action field telling the AI exactly how to fix missing credentials. - Use Case: When a user says "list my beam agents", the calling skill runs check_beam_config.py first, then list_agents.py, pulling error-handling.md only if something fails. ## Quick Start Ask the AI to list your Beam agents and it will validate configuration then run the shared list_agents script.

Frequently Asked Questions about beam-master

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up Beam AI API credentials?

Run the setup_beam.py script for an interactive wizard, or manually add BEAM_API_KEY (starting with bm_key_) and BEAM_WORKSPACE_ID to your .env file. Get both from your Beam workspace settings.

How do I create and run a Beam agent task?

Use create_task.py with --agent-id and --query arguments to POST a new task. Monitor progress with get_task.py or stream real-time updates via get_task_updates.py using the returned task ID.

How does Beam API authentication work?

Beam uses two-step authentication: exchange your API key at POST /auth/access-token for an idToken, then send it as a Bearer header with current-workspace-id. Tokens expire after one hour and can be refreshed.

Why am I getting 401 Unauthorized errors from the Beam API?

A 401 means your access token expired, your API key is invalid, or the Authorization header is missing. Refresh the token with refresh_token.py or re-authenticate with get_access_token.py.

How do I handle Beam tasks waiting for human input?

Tasks in WAITING_FOR_CONSENT or WAITING_FOR_USER_INPUT status need HITL action. Use approve_task.py, reject_task.py, or provide_user_input.py with the task ID to continue execution.