Git Identity Configuration

Configure custom git commit author identity for PraisonAI

Configure custom git commit author identity across PraisonAI CLI commands and internal services.

Quick Start

1. Set Environment Variables

   Configure your git identity using environment variables:

   export PRAISONAI_GIT_USER_NAME="Your Name"
   export PRAISONAI_GIT_USER_EMAIL="[e-mail]"
   
2. Use GitHub Noreply Email

   Protect your personal email on GitHub:

   export PRAISONAI_GIT_USER_NAME="YourUsername"
   export PRAISONAI_GIT_USER_EMAIL="[e-mail]"
   
3. Test Configuration

   Verify the configuration works:

   praisonai commit -a
   # Commits will now show: Your Name <[e-mail]>
   

---

How It Works

PraisonAI reads identity configuration in this priority order:

Priority	Method	Example
1	Explicit parameter	CheckpointService(user_name="Custom")
2	Environment variables	PRAISONAI_GIT_USER_NAME
3	Default values	"PraisonAI"

---

Environment Variables

Variable	Description	Default
PRAISONAI_GIT_USER_NAME	Git user.name for commits	"PraisonAI"
PRAISONAI_GIT_USER_EMAIL	Git user.email for commits	Service-specific

Default email varies by service:

• CLI commands: No default (uses global git config)
• CheckpointService: "[e-mail]"
• FileSnapshot: "[e-mail]"

---

Setup Methods

Shell Configuration

Add to your shell profile (~/.bashrc, ~/.zshrc, ~/.bash_profile):

# Personal identity
export PRAISONAI_GIT_USER_NAME="John Doe"
export PRAISONAI_GIT_USER_EMAIL="[e-mail]"

# GitHub noreply (recommended)
export PRAISONAI_GIT_USER_NAME="johndoe"
export PRAISONAI_GIT_USER_EMAIL="[e-mail]"

Reload your shell:

source ~/.zshrc  # or ~/.bashrc

Session Only

Set for current session only:

export PRAISONAI_GIT_USER_NAME="Temporary User"
export PRAISONAI_GIT_USER_EMAIL="[e-mail]"

# Verify
echo $PRAISONAI_GIT_USER_NAME
echo $PRAISONAI_GIT_USER_EMAIL

Project Specific

Create a .env file in your project:

# .env
PRAISONAI_GIT_USER_NAME=ProjectUser
PRAISONAI_GIT_USER_EMAIL=[e-mail]

Load before running PraisonAI:

source .env
praisonai commit -a

---

Affected Components

CLI Commands

The praisonai commit command uses the environment variables for git author:

from praisonaiagents import Agent

# Environment variables are automatically used
# No code changes needed

Checkpoint Service

Internal checkpoints use the configured identity:

from praisonaiagents import CheckpointService

# Uses environment variables automatically
service = CheckpointService(workspace_dir="./project")

# Or override explicitly
service = CheckpointService(
    workspace_dir="./project",
    user_name="Override Name",
    user_email="[e-mail]"
)

File Snapshot

File snapshots use the configured identity:

from praisonaiagents.snapshot import FileSnapshot

# Uses environment variables automatically
snapshot = FileSnapshot(project_path="./project")

# Or override explicitly
snapshot = FileSnapshot(
    project_path="./project", 
    user_name="Override Name",
    user_email="[e-mail]"
)

---

Common Patterns

GitHub Integration

Using GitHub noreply email for privacy:

export PRAISONAI_GIT_USER_NAME="MervinPraison"
export PRAISONAI_GIT_USER_EMAIL="[e-mail]"

This ensures:

• Commits are attributed to your GitHub account
• Your personal email is not exposed
• GitHub shows your profile picture and username

Team Environment

Set team-wide defaults using environment management:

# Development environment
export PRAISONAI_GIT_USER_NAME="Dev Team"
export PRAISONAI_GIT_USER_EMAIL="[e-mail]"

# Production environment  
export PRAISONAI_GIT_USER_NAME="Production Bot"
export PRAISONAI_GIT_USER_EMAIL="[e-mail]"

Multi-Project Setup

Different identities for different projects:

# Project A
cd project-a
export PRAISONAI_GIT_USER_NAME="Team A"
export PRAISONAI_GIT_USER_EMAIL="[e-mail]"
praisonai commit -a

# Project B
cd ../project-b
export PRAISONAI_GIT_USER_NAME="Team B" 
export PRAISONAI_GIT_USER_EMAIL="[e-mail]"
praisonai commit -a

---

Best Practices

Use GitHub Noreply Email

Always use GitHub’s noreply email format to protect your privacy:

# Format: {username}@users.noreply.github.com
export PRAISONAI_GIT_USER_EMAIL="[e-mail]"

Benefits:

• Commits link to your GitHub profile
• Personal email stays private
• Works with all GitHub features

Set in Shell Profile

Add variables to your shell configuration for persistence:

# ~/.zshrc or ~/.bashrc
export PRAISONAI_GIT_USER_NAME="Your Name"
export PRAISONAI_GIT_USER_EMAIL="[e-mail]"

This ensures the configuration persists across sessions.

Verify Configuration

Always verify your configuration before committing:

echo "Name: $PRAISONAI_GIT_USER_NAME"
echo "Email: $PRAISONAI_GIT_USER_EMAIL"

# Test with a small commit
praisonai commit -a
git log --oneline -1  # Check the author

Override When Needed

Use explicit parameters for special cases:

# For automated systems
service = CheckpointService(
    workspace_dir="./project",
    user_name="Automated System",
    user_email="[e-mail]"
)

---

Related

AI Commit

Generate AI-powered commit messages

Git Integration

PraisonAI git workflow integration