blob: 841ab2465b03e701e674b3e90d33ff4fe47bf840 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
|
# Strangeloop
A recursive and self-referential AI agent framework.
## Installation
Run the latest version directly without installation from `uvx`:
```bash
$ uvx strangeloop
```
For developers, from within working copy run:
```bash
$ uv run strangeloop
```
## CLI Usage
Strangeloop provides a command-line interface with several commands:
```bash
# Run the CLI ad hoc without installation
strangeloop --help
strangeloop hello
strangeloop greet [NAME]
strangeloop info
strangeloop process FILE_PATH [--output OUTPUT_PATH]
# Ask Claude Sonnet 3.7 a question
strangeloop ask "What is recursive self-improvement in AI?"
# Use the AI agent loop to fulfill requests
strangeloop do "find the current weather in New York"
strangeloop do "create a function to generate secure passwords"
# Manage capabilities
strangeloop capability add "generate a secure random password"
strangeloop capability list
strangeloop capability show generate_secure_password
strangeloop capability run generate_secure_password 16 --include-special-chars
# Configuration management
strangeloop config set anthropic_api_key "your-api-key"
strangeloop config get anthropic_api_key
strangeloop config list
strangeloop config delete anthropic_api_key
strangeloop config path
```
If you've installed the package:
```bash
# Using the installed CLI
strangeloop --help
strangeloop hello
strangeloop greet [NAME]
strangeloop info
strangeloop ask "What is the meaning of life?" --max-tokens 2048 --temperature 0.8
```
## AI Agent Loop
The core of Strangeloop is the AI agent loop, which allows you to make requests in natural language and have the system determine the best way to fulfill them:
```bash
strangeloop do "find information about the weather in Paris"
```
The system will:
1. Analyze your request
2. Check available capabilities
3. Either:
- Use an existing capability
- Create a new capability
- Provide a direct response
You can control the execution with options:
```bash
# Don't automatically execute the suggested action
strangeloop do "analyze this log file" --no-auto-execute
# Adjust the temperature for more creative responses
strangeloop do "write a poem about AI" --temperature 0.9
```
## Capabilities Management
Strangeloop allows you to create, manage, and execute capabilities - Python functions that can be dynamically added to the system:
### Adding Capabilities
```bash
# Add a new capability
strangeloop capability add "generate a secure random password"
# Control the generation parameters
strangeloop capability add "fetch current weather for a location" --temperature 0.5 --max-tokens 4096
```
### Listing and Viewing Capabilities
```bash
# List all available capabilities
strangeloop capability list
# Get detailed information about capabilities
strangeloop capability list --verbose
# Show details of a specific capability
strangeloop capability show generate_secure_password
```
### Running Capabilities
```bash
# Run a capability with arguments
strangeloop capability run generate_secure_password 16 true
# Parse arguments as JSON
strangeloop capability run fetch_weather "New York" --json
```
## API Keys and Configuration
To use the Claude Sonnet 3.7 integration, you need to provide your Anthropic API key in one of these ways (in order of precedence):
1. Set in configuration:
```bash
strangeloop config set anthropic_api_key "your-api-key"
```
2. Set as environment variable:
```bash
export ANTHROPIC_API_KEY="your-api-key"
```
## Configuration
Strangeloop uses the XDG Base Directory Specification for storing configuration. The configuration file is stored at:
- Linux/macOS: `~/.config/strangeloop/config.json` (or `$XDG_CONFIG_HOME/strangeloop/config.json` if set)
- Windows: `%APPDATA%\strangeloop\config.json`
You can manage configuration using the `config` command:
```bash
# Set a configuration value
strangeloop config set model "claude-3-opus-20240229"
# Get a configuration value
strangeloop config get model
# List all configuration values
strangeloop config list
# Delete a configuration value
strangeloop config delete model
# Show the configuration file path
strangeloop config path
```
### Common Configuration Options
- `anthropic_api_key`: Your Anthropic API key
|
