Get Pallas working with your agent.

Installation, authorization and help for Engineering Alpha 0.1.4.

Installation

You need Python 3.12 or 3.13, macOS or Linux, and a supported agent. The complete current test bundle targets macOS + Codex; Claude Code uses its separate setup path. Dependencies need network access during installation.

You also need a Pallas test wheel obtained through the testing arrangement. This page has no public download or PyPI installation link. The steps below start after you have received the matching 0.1.4 wheel. A configured package and a source build can have different authorization prerequisites.

Create a new pallas-test folder, place the wheel inside, and open a terminal there. With Python 3.13:

python3.13 -m venv .venv
.venv/bin/python -m pip install ./pallas_ads-0.1.4-py3-none-any.whl

Use python3.12 instead if that is your installed supported version. Keep the .venv folder after setup.

Connect your agent

Create a new or empty project directory for Pallas. Setup writes project-local configuration, a workspace, analysis Skills and a report template. It does not log you in automatically.

Codex

.venv/bin/pallas agent setup --client codex --directory "$PWD/codex-test"

Open the generated project in Codex and start a new task. This general command does not enable the special Meta test route. For Meta, use the configured test-bundle instructions for your host. The current Codex route uses a preregistered application and local HTTPS certificate trust; Claude Code has a different route.

Claude Code

.venv/bin/pallas agent setup --client claude --directory "$PWD/claude-test"

Open the generated project in Claude Code and review its server permissions. Meta authentication is handled by the host's official MCP connection.

Try an example

Try an example without an advertising account, using a new output directory:

.venv/bin/pallas demo --output-dir "$PWD/demo-output"

This produces synthetic example data, not real account results.

Authorization

Google Ads: use the configured package's browser flow and an account eligible for the application and API access. A source build may require separate application setup. External-user access depends on application eligibility and Google Ads API access; live performance reconciliation remains limited. A successful login does not grant access to accounts you do not control.

Meta Ads: the host connects to the official MCP service and holds the authorization. Host setup and application audience limits still apply. Pallas's current analysis path is limited evidence review; the host tool guard does not narrow the platform's OAuth grant itself.

TikTok Ads: use the official MCP browser authorization path. Access depends on your account permissions and the platform service. Available report analysis is not a guarantee that every live metric is verified.

Questions

Which agents are supported?

The current documented integrations are Codex and Claude Code. Their setup and authorization paths differ. The logos do not imply integration with the ChatGPT chat website.

Does Pallas run a model or optimize my ads automatically?

No. Your agent handles reasoning and interaction. Pallas supplies local tools and reports and does not modify advertisements.

Authorization failed. What should I do?

Check the selected host, package version and platform-account permissions. Read the reported error, including any incomplete-revocation or cleanup warning. Retrying does not remove application eligibility limits. Send a redacted error description to support if you need help; do not send credentials.

Can I use an existing project?

Setup requires a new or empty project directory. Do not replace an existing agent configuration to force setup through.

How do I revoke access or remove data?

Follow Data deletion. Revoking platform access, removing local or host credentials, and deleting reports are separate actions.

Contact

If you have any question, contact us with email. Include your OS, agent, Pallas version, platform and a short description. Remove tokens, passwords, account identifiers and sensitive advertising data from examples. The developer handles support requests; no response-time guarantee is offered.