UPLOAD_INSTRUCTIONS.md

How to Upload AgentChat to PyPI

Your package is built and ready to upload! Follow these steps:

1. Create a PyPI Account (if you don't have one)

Visit https://pypi.org/account/register/

2. Create an API Token

1. Log into PyPI
2. Go to Account Settings → API tokens
3. Create a new token (choose "Entire account" scope for first upload)
4. Copy the token (it starts with pypi-)

3. Upload Your Package

Option A: Using command line (interactive):

python3 -m twine upload dist/*

• Username: __token__
• Password: [paste your API token]

Option B: Using environment variables:

export TWINE_USERNAME=__token__
export TWINE_PASSWORD=pypi-AgBJ... # Your actual token
python3 -m twine upload dist/*

Option C: Create a .pypirc file in your home directory:

[pypi]
username = __token__
password = pypi-AgBJ... # Your actual token

4. Test Your Package

After uploading, wait a few minutes and then:

pip install agentchat

Important Notes:

• Make sure to update the author information in pyproject.toml and other files before uploading
• If "agentchat" is already taken, you'll need to change the package name in pyproject.toml
• For test uploads, use TestPyPI first: https://test.pypi.org/

Troubleshooting:

• If the name is taken, modify pyproject.toml to use a different name (e.g., agentchat-yourusername)
• After changing the name, rebuild with python3 -m build --outdir dist
• Then upload again with python3 -m twine upload dist/*