this repo has no description
Clear agents dir
-529
-134
agents/README.md
-134
agents/README.md
···
1
-
# Agent Configurations
2
-
3
-
This directory contains agent-specific configuration files for the Jetstream-Letta bridge. Each configuration defines a different Letta agent with its own personality, behavior, and monitoring settings.
4
-
5
-
## Available Agents
6
-
7
-
### 🔧 Technical Agent (`technical.yaml`)
8
-
- **Purpose**: Handles technical discussions, code reviews, and engineering topics
9
-
- **Batch Size**: 1 (immediate responses)
10
-
- **Max Steps**: 100
11
-
- **Best For**: Developer communities, tech support, code discussions
12
-
13
-
### 🎨 Creative Agent (`creative.yaml`)
14
-
- **Purpose**: Specializes in creative writing, poetry, storytelling, and artistic discussions
15
-
- **Batch Size**: 3 (processes in batches for better context)
16
-
- **Max Steps**: 150
17
-
- **Best For**: Writing communities, artistic discussions, creative feedback
18
-
19
-
### 📊 Analytical Agent (`analytical.yaml`)
20
-
- **Purpose**: Data analysis, research, fact-checking, and analytical discussions
21
-
- **Batch Size**: 5 (processes larger batches for comprehensive analysis)
22
-
- **Max Steps**: 200
23
-
- **Best For**: Research communities, academic discussions, data analysis
24
-
25
-
## Configuration Structure
26
-
27
-
Each agent configuration file contains:
28
-
29
-
```yaml
30
-
# Agent-specific settings
31
-
agent:
32
-
name: "Agent Name"
33
-
agent_id: "your-letta-agent-uuid"
34
-
batch_size: 1-5
35
-
max_steps: 100-200
36
-
37
-
# Bluesky authentication (can be shared across agents)
38
-
bluesky:
39
-
username: "your.handle.bsky.social"
40
-
password: "your-app-password"
41
-
pds_uri: "https://bsky.social"
42
-
43
-
# Jetstream monitoring settings
44
-
jetstream:
45
-
instance: "wss://jetstream2.us-west.bsky.network"
46
-
wanted_dids: ["did:plc:community1", "did:plc:community2"]
47
-
48
-
# Letta API settings
49
-
letta:
50
-
api_key: "your-letta-api-key"
51
-
agent_id: "same-as-agent.agent_id"
52
-
timeout: 600-1200
53
-
54
-
# Other settings...
55
-
```
56
-
57
-
## Setup Instructions
58
-
59
-
1. **Copy a template**: Start with one of the existing configurations
60
-
2. **Update credentials**:
61
-
- Set your Bluesky username and app password
62
-
- Set your Letta API key
63
-
- Replace agent IDs with your actual Letta agent UUIDs
64
-
3. **Configure monitoring**:
65
-
- Add DIDs of communities you want the agent to monitor
66
-
- Adjust batch size and timeout based on agent purpose
67
-
4. **Test the configuration**:
68
-
```bash
69
-
python src/jetstream_letta_bridge.py --agent agents/your-agent.yaml --verbose
70
-
```
71
-
72
-
## Usage Examples
73
-
74
-
### Using the Python script directly:
75
-
```bash
76
-
# Run a specific agent
77
-
python src/jetstream_letta_bridge.py --agent agents/technical.yaml
78
-
79
-
# Run with additional options
80
-
python src/jetstream_letta_bridge.py --agent agents/creative.yaml --verbose --batch-size 2
81
-
82
-
# List available agents
83
-
python src/jetstream_letta_bridge.py --list-agents agents/
84
-
```
85
-
86
-
### Using the helper script:
87
-
```bash
88
-
# Quick agent switching
89
-
./run_agent.sh technical
90
-
./run_agent.sh creative --verbose
91
-
./run_agent.sh analytical --batch-size 10
92
-
93
-
# List agents with details
94
-
./run_agent.sh list
95
-
96
-
# Show help
97
-
./run_agent.sh help
98
-
```
99
-
100
-
### Using environment variables:
101
-
```bash
102
-
# Set default agent
103
-
export LETTA_AGENT_CONFIG=agents/technical.yaml
104
-
python src/jetstream_letta_bridge.py
105
-
106
-
# Override specific settings
107
-
export BLUESKY_USERNAME=other.handle.bsky.social
108
-
export LETTA_API_KEY=different-api-key
109
-
./run_agent.sh creative
110
-
```
111
-
112
-
## Creating New Agents
113
-
114
-
1. Copy an existing configuration file
115
-
2. Rename it to something descriptive (e.g., `support-bot.yaml`)
116
-
3. Update the agent settings:
117
-
- Change `agent.name` and `agent.agent_id`
118
-
- Adjust `batch_size` and `max_steps` for your use case
119
-
- Modify `wanted_dids` to monitor relevant communities
120
-
4. Test the configuration before using in production
121
-
122
-
## Best Practices
123
-
124
-
- **Batch Size**:
125
-
- 1 for immediate responses (support, technical help)
126
-
- 3-5 for contextual responses (creative, analytical)
127
-
- **Max Steps**:
128
-
- 100 for quick responses
129
-
- 150-200 for complex tasks
130
-
- **Timeout**:
131
-
- 600s (10min) for most agents
132
-
- 900-1200s (15-20min) for analytical/creative tasks
133
-
- **DIDs**: Monitor specific communities rather than all DIDs for focused responses
134
-
- **Credentials**: You can share Bluesky credentials across agents, but use different agent IDs
-76
agents/analytical.yaml
-76
agents/analytical.yaml
···
1
-
# Analytical Agent Configuration
2
-
# Specializes in data analysis, research, fact-checking, and analytical discussions
3
-
4
-
# Agent-specific configuration
5
-
agent:
6
-
name: "AnalyticalBot"
7
-
agent_id: "agent-analytical-uuid-replace-this" # Replace with your actual agent ID
8
-
batch_size: 5 # Process messages in larger batches for comprehensive analysis
9
-
max_steps: 200 # Allow more steps for thorough analysis
10
-
11
-
# Bluesky/ATProto authentication configuration
12
-
bluesky:
13
-
# Your Bluesky handle (e.g., alice.bsky.social) or email
14
-
username: "your.handle.bsky.social"
15
-
16
-
# Your Bluesky app password (not your main account password!)
17
-
# Generate at: https://bsky.app/settings/app-passwords
18
-
password: "your-app-password-here"
19
-
20
-
# ATProto PDS URI - use https://bsky.social for Bluesky
21
-
# For self-hosted PDS, use your custom URI
22
-
pds_uri: "https://bsky.social"
23
-
24
-
# Jetstream websocket configuration
25
-
jetstream:
26
-
# Jetstream instance to connect to
27
-
instance: "wss://jetstream2.us-west.bsky.network"
28
-
29
-
# List of DIDs to monitor for analytical/research topics
30
-
# Add DIDs of researchers, analysts, academic communities, etc.
31
-
wanted_dids:
32
-
- "did:plc:example-research-community"
33
-
- "did:plc:example-academic-network"
34
-
- "did:plc:example-data-science-group"
35
-
# Add more DIDs as needed
36
-
37
-
# Reconnection settings
38
-
reconnect_delay: 5
39
-
max_reconnect_attempts: 10
40
-
41
-
# Cache configuration for DID resolution
42
-
cache:
43
-
# Time-to-live for DID cache entries in seconds
44
-
did_cache_ttl: 3600 # 1 hour
45
-
46
-
# Maximum number of DIDs to cache
47
-
max_cache_size: 1000
48
-
49
-
# Letta agent configuration
50
-
letta:
51
-
# Letta API key (get from your Letta instance)
52
-
api_key: "sk-let-your-api-key-here"
53
-
54
-
# Request timeout in seconds (longer for analytical tasks)
55
-
timeout: 1200 # 20 minutes for complex analysis
56
-
57
-
# Letta project ID (optional - uses default if not specified)
58
-
# project_id: "your-project-id"
59
-
60
-
# This should match the agent.agent_id above
61
-
agent_id: "agent-analytical-uuid-replace-this"
62
-
63
-
# Agent behavior configuration
64
-
bridge:
65
-
# Prompt template for analytical discussions
66
-
prompt_template: "[@{author}] {content}"
67
-
68
-
# Include metadata in prompts for analytical context
69
-
include_metadata: true
70
-
71
-
# Environment variable overrides:
72
-
# - BLUESKY_USERNAME: Override bluesky.username
73
-
# - BLUESKY_PASSWORD: Override bluesky.password
74
-
# - PDS_URI: Override bluesky.pds_uri
75
-
# - LETTA_API_KEY: Override letta.api_key
76
-
# - LETTA_AGENT_CONFIG: Override entire config file path
-76
agents/creative.yaml
-76
agents/creative.yaml
···
1
-
# Creative Writing Agent Configuration
2
-
# Specializes in creative writing, poetry, storytelling, and artistic discussions
3
-
4
-
# Agent-specific configuration
5
-
agent:
6
-
name: "CreativeBot"
7
-
agent_id: "agent-creative-uuid-replace-this" # Replace with your actual agent ID
8
-
batch_size: 3 # Process messages in batches for better creative context
9
-
max_steps: 150 # Allow more steps for creative elaboration
10
-
11
-
# Bluesky/ATProto authentication configuration
12
-
bluesky:
13
-
# Your Bluesky handle (e.g., alice.bsky.social) or email
14
-
username: "your.handle.bsky.social"
15
-
16
-
# Your Bluesky app password (not your main account password!)
17
-
# Generate at: https://bsky.app/settings/app-passwords
18
-
password: "your-app-password-here"
19
-
20
-
# ATProto PDS URI - use https://bsky.social for Bluesky
21
-
# For self-hosted PDS, use your custom URI
22
-
pds_uri: "https://bsky.social"
23
-
24
-
# Jetstream websocket configuration
25
-
jetstream:
26
-
# Jetstream instance to connect to
27
-
instance: "wss://jetstream2.us-west.bsky.network"
28
-
29
-
# List of DIDs to monitor for creative communities
30
-
# Add DIDs of writers, artists, poets, creative communities, etc.
31
-
wanted_dids:
32
-
- "did:plc:example-writers-group"
33
-
- "did:plc:example-poetry-circle"
34
-
- "did:plc:example-artist-community"
35
-
# Add more DIDs as needed
36
-
37
-
# Reconnection settings
38
-
reconnect_delay: 5
39
-
max_reconnect_attempts: 10
40
-
41
-
# Cache configuration for DID resolution
42
-
cache:
43
-
# Time-to-live for DID cache entries in seconds
44
-
did_cache_ttl: 3600 # 1 hour
45
-
46
-
# Maximum number of DIDs to cache
47
-
max_cache_size: 1000
48
-
49
-
# Letta agent configuration
50
-
letta:
51
-
# Letta API key (get from your Letta instance)
52
-
api_key: "sk-let-your-api-key-here"
53
-
54
-
# Request timeout in seconds (longer for creative tasks)
55
-
timeout: 900
56
-
57
-
# Letta project ID (optional - uses default if not specified)
58
-
# project_id: "your-project-id"
59
-
60
-
# This should match the agent.agent_id above
61
-
agent_id: "agent-creative-uuid-replace-this"
62
-
63
-
# Agent behavior configuration
64
-
bridge:
65
-
# Prompt template for creative discussions
66
-
prompt_template: "[@{author}] {content}"
67
-
68
-
# Include metadata in prompts for creative context
69
-
include_metadata: true
70
-
71
-
# Environment variable overrides:
72
-
# - BLUESKY_USERNAME: Override bluesky.username
73
-
# - BLUESKY_PASSWORD: Override bluesky.password
74
-
# - PDS_URI: Override bluesky.pds_uri
75
-
# - LETTA_API_KEY: Override letta.api_key
76
-
# - LETTA_AGENT_CONFIG: Override entire config file path
-92
agents/grunk.yaml
-92
agents/grunk.yaml
···
1
-
# Configuration for thought.stream ATProto multi-agent communication system
2
-
3
-
# Bluesky/ATProto authentication configuration
4
-
bluesky:
5
-
# Your Bluesky handle (e.g., alice.bsky.social) or email
6
-
username: "grunk.comind.network"
7
-
8
-
# Your Bluesky app password (not your main account password!)
9
-
# Generate at: https://bsky.app/settings/app-passwords
10
-
password: "mwwc-stpc-5pga-zy5s"
11
-
12
-
# ATProto PDS URI - use https://bsky.social for Bluesky
13
-
# For self-hosted PDS, use your custom URI
14
-
pds_uri: "https://comind.network"
15
-
16
-
# Jetstream websocket configuration
17
-
jetstream:
18
-
# Jetstream instance to connect to
19
-
# Available instances:
20
-
# - wss://jetstream1.us-east.bsky.network
21
-
# - wss://jetstream2.us-east.bsky.network
22
-
# - wss://jetstream1.us-west.bsky.network
23
-
# - wss://jetstream2.us-west.bsky.network
24
-
instance: "wss://jetstream2.us-west.bsky.network"
25
-
26
-
# List of DIDs to monitor for blips (optional)
27
-
# If empty, will monitor all DIDs
28
-
wanted_dids:
29
-
- "did:plc:gfrmhdmjvxn2sjedzboeudef" # Cameron
30
-
# - "did:plc:anotherdid12345"
31
-
32
-
# Reconnection settings
33
-
reconnect_delay: 5 # Base delay in seconds between reconnection attempts
34
-
max_reconnect_attempts: 10 # Maximum reconnection attempts (0 = unlimited)
35
-
36
-
37
-
# Cache configuration for DID resolution
38
-
cache:
39
-
# Time-to-live for DID cache entries in seconds
40
-
did_cache_ttl: 3600 # 1 hour
41
-
42
-
# Maximum number of DIDs to cache
43
-
max_cache_size: 1000
44
-
45
-
# Letta agent configuration for stream.thought.blip publishing
46
-
letta:
47
-
# Letta API key (get from your Letta instance)
48
-
api_key: "sk-let-MTNjYjFkOTctYWViNS00NzU3LTk5YzAtM2M5ZmEzY2U1NTUwOjFmMTZmNTEzLWFjMWUtNGJlZC04MTAzLWRhY2ZjMDlkMWNkNA=="
49
-
50
-
# Request timeout in seconds
51
-
timeout: 600
52
-
53
-
# Letta project ID (optional - uses default if not specified)
54
-
# project_id: "your-project-id"
55
-
56
-
# Letta agent ID to communicate with
57
-
agent_id: "agent-314bb3c0-a5be-4906-ad5b-c0729e5d1592"
58
-
59
-
# Agent behavior configuration
60
-
agent:
61
-
# Number of messages to batch before publishing as blips
62
-
# Set to 1 for immediate publishing of each send_message call
63
-
batch_size: 1
64
-
65
-
# Maximum steps for agent responses
66
-
max_steps: 100
67
-
68
-
# Listener configuration
69
-
listener:
70
-
# Mode
71
-
# mode: "poll"
72
-
73
-
# How often to prompt the agent (in seconds)
74
-
poll_interval: 60
75
-
76
-
# Default prompt template when no specific prompt is given
77
-
prompt_template: "What's on your mind? Feel free to share any thoughts using send_message."
78
-
79
-
# List of automatic prompts to cycle through (optional)
80
-
auto_prompts:
81
-
- "What's happening in your world today?"
82
-
- "Any interesting thoughts to share?"
83
-
- "How are you feeling about recent events?"
84
-
- "What would you like to tell the network?"
85
-
86
-
# Environment variable overrides:
87
-
# - BLUESKY_USERNAME: Override bluesky.username
88
-
# - BLUESKY_PASSWORD: Override bluesky.password
89
-
# - PDS_URI: Override bluesky.pds_uri
90
-
# - JETSTREAM_INSTANCE: Override jetstream.instance
91
-
# - WANTED_DIDS: Override jetstream.wanted_dids (comma-separated)
92
-
# - LETTA_API_KEY: Override letta.api_key# Cache configuration for DID resolution
-28
agents/herald.yaml
-28
agents/herald.yaml
···
1
-
bluesky:
2
-
username: herald.comind.network
3
-
password: pzxf-sgle-7ms6-lejf
4
-
pds_uri: https://comind.network
5
-
letta:
6
-
api_key: sk-let-MTNjYjFkOTctYWViNS00NzU3LTk5YzAtM2M5ZmEzY2U1NTUwOmY1Y2FlODA3LTQzYzAtNDM3Yi04MWNlLTA0ZWEyYjkyMzlhNA==
7
-
timeout: 60
8
-
agent_id: agent-8c6c713e-4c3b-406c-b0b9-b9a40f583ee3
9
-
agent:
10
-
agent_id: agent-8c6c713e-4c3b-406c-b0b9-b9a40f583ee3
11
-
batch_size: 30
12
-
queue_flush_timeout: 120
13
-
max_steps: 100
14
-
jetstream:
15
-
instance: wss://jetstream2.us-west.bsky.network
16
-
wanted_dids: []
17
-
reconnect_delay: 5
18
-
max_reconnect_attempts: 10
19
-
cache:
20
-
did_cache_ttl: 3600
21
-
max_cache_size: 1000
22
-
bridge:
23
-
prompt_template: '[@{author}] {content}'
24
-
include_metadata: true
25
-
listener:
26
-
mode: event
27
-
queue_check_interval: 5
28
-
prompt_template: What's on your mind? Feel free to share any thoughts using send_message.
-23
agents/kaleidoscope.yaml
-23
agents/kaleidoscope.yaml
···
1
-
bluesky:
2
-
username: prism.comind.network
3
-
password: wjlf-v3hd-hatk-dwwf
4
-
pds_uri: https://comind.network
5
-
letta:
6
-
api_key: sk-let-MTNjYjFkOTctYWViNS00NzU3LTk5YzAtM2M5ZmEzY2U1NTUwOmY1Y2FlODA3LTQzYzAtNDM3Yi04MWNlLTA0ZWEyYjkyMzlhNA==
7
-
timeout: 30
8
-
agent_id: agent-475dc185-7954-4b71-b4a8-c2c84dbb349d
9
-
agent:
10
-
agent_id: agent-475dc185-7954-4b71-b4a8-c2c84dbb349d
11
-
batch_size: 1
12
-
max_steps: 100
13
-
jetstream:
14
-
instance: wss://jetstream2.us-west.bsky.network
15
-
wanted_dids: []
16
-
reconnect_delay: 5
17
-
max_reconnect_attempts: 10
18
-
cache:
19
-
did_cache_ttl: 3600
20
-
max_cache_size: 1000
21
-
bridge:
22
-
prompt_template: '[@{author}] {content}'
23
-
include_metadata: true
-24
agents/pedant.yaml
-24
agents/pedant.yaml
···
1
-
bluesky:
2
-
username: pedant.comind.network
3
-
password: hzel-ztma-6nbg-drqy
4
-
pds_uri: https://comind.network
5
-
letta:
6
-
api_key: sk-let-MTNjYjFkOTctYWViNS00NzU3LTk5YzAtM2M5ZmEzY2U1NTUwOmY1Y2FlODA3LTQzYzAtNDM3Yi04MWNlLTA0ZWEyYjkyMzlhNA==
7
-
timeout: 60
8
-
agent_id: agent-f622c272-04fa-401e-85d1-19b7c49dcfbb
9
-
agent:
10
-
agent_id: agent-f622c272-04fa-401e-85d1-19b7c49dcfbb
11
-
batch_size: 30
12
-
queue_flush_timeout: 120
13
-
max_steps: 100
14
-
jetstream:
15
-
instance: wss://jetstream2.us-west.bsky.network
16
-
wanted_dids: []
17
-
reconnect_delay: 5
18
-
max_reconnect_attempts: 10
19
-
cache:
20
-
did_cache_ttl: 3600
21
-
max_cache_size: 1000
22
-
bridge:
23
-
prompt_template: '[@{author}] {content}'
24
-
include_metadata: true
-76
agents/technical.yaml
-76
agents/technical.yaml
···
1
-
# Technical Assistant Agent Configuration
2
-
# Specializes in technical discussions, code reviews, and engineering topics
3
-
4
-
# Agent-specific configuration
5
-
agent:
6
-
name: "TechBot"
7
-
agent_id: "agent-tech-uuid-replace-this" # Replace with your actual agent ID
8
-
batch_size: 1 # Process messages immediately for quick technical responses
9
-
max_steps: 100
10
-
11
-
# Bluesky/ATProto authentication configuration
12
-
bluesky:
13
-
# Your Bluesky handle (e.g., alice.bsky.social) or email
14
-
username: "your.handle.bsky.social"
15
-
16
-
# Your Bluesky app password (not your main account password!)
17
-
# Generate at: https://bsky.app/settings/app-passwords
18
-
password: "your-app-password-here"
19
-
20
-
# ATProto PDS URI - use https://bsky.social for Bluesky
21
-
# For self-hosted PDS, use your custom URI
22
-
pds_uri: "https://bsky.social"
23
-
24
-
# Jetstream websocket configuration
25
-
jetstream:
26
-
# Jetstream instance to connect to
27
-
instance: "wss://jetstream2.us-west.bsky.network"
28
-
29
-
# List of DIDs to monitor for technical topics
30
-
# Add DIDs of technical communities, developers, etc.
31
-
wanted_dids:
32
-
- "did:plc:example-tech-community"
33
-
- "did:plc:example-developer-1"
34
-
# Add more DIDs as needed
35
-
36
-
# Reconnection settings
37
-
reconnect_delay: 5
38
-
max_reconnect_attempts: 10
39
-
40
-
# Cache configuration for DID resolution
41
-
cache:
42
-
# Time-to-live for DID cache entries in seconds
43
-
did_cache_ttl: 3600 # 1 hour
44
-
45
-
# Maximum number of DIDs to cache
46
-
max_cache_size: 1000
47
-
48
-
# Letta agent configuration
49
-
letta:
50
-
# Letta API key (get from your Letta instance)
51
-
api_key: "sk-let-your-api-key-here"
52
-
53
-
# Request timeout in seconds
54
-
timeout: 600
55
-
56
-
# Letta project ID (optional - uses default if not specified)
57
-
# project_id: "your-project-id"
58
-
59
-
# This should match the agent.agent_id above
60
-
agent_id: "agent-tech-uuid-replace-this"
61
-
62
-
# Agent behavior configuration
63
-
# Note: These settings affect how the bridge processes messages
64
-
bridge:
65
-
# Prompt template for technical discussions
66
-
prompt_template: "[@{author}] {content}"
67
-
68
-
# Include metadata in prompts
69
-
include_metadata: true
70
-
71
-
# Environment variable overrides:
72
-
# - BLUESKY_USERNAME: Override bluesky.username
73
-
# - BLUESKY_PASSWORD: Override bluesky.password
74
-
# - PDS_URI: Override bluesky.pds_uri
75
-
# - LETTA_API_KEY: Override letta.api_key
76
-
# - LETTA_AGENT_CONFIG: Override entire config file path