npcsh 1.0.14__py3-none-any.whl → 1.0.17__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- npcsh/_state.py +1536 -78
- npcsh/corca.py +709 -0
- npcsh/guac.py +1433 -596
- npcsh/mcp_server.py +64 -60
- npcsh/npc.py +125 -98
- npcsh/npcsh.py +41 -1318
- npcsh/pti.py +195 -215
- npcsh/routes.py +106 -36
- npcsh/spool.py +138 -144
- {npcsh-1.0.14.dist-info → npcsh-1.0.17.dist-info}/METADATA +37 -367
- npcsh-1.0.17.dist-info/RECORD +21 -0
- {npcsh-1.0.14.dist-info → npcsh-1.0.17.dist-info}/entry_points.txt +1 -1
- npcsh/mcp_npcsh.py +0 -822
- npcsh-1.0.14.dist-info/RECORD +0 -21
- {npcsh-1.0.14.dist-info → npcsh-1.0.17.dist-info}/WHEEL +0 -0
- {npcsh-1.0.14.dist-info → npcsh-1.0.17.dist-info}/licenses/LICENSE +0 -0
- {npcsh-1.0.14.dist-info → npcsh-1.0.17.dist-info}/top_level.txt +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: npcsh
|
|
3
|
-
Version: 1.0.
|
|
3
|
+
Version: 1.0.17
|
|
4
4
|
Summary: npcsh is a command-line toolkit for using AI agents in novel ways.
|
|
5
5
|
Home-page: https://github.com/NPC-Worldwide/npcsh
|
|
6
6
|
Author: Christopher Agostino
|
|
@@ -16,8 +16,10 @@ Requires-Dist: litellm
|
|
|
16
16
|
Requires-Dist: docx
|
|
17
17
|
Requires-Dist: scipy
|
|
18
18
|
Requires-Dist: numpy
|
|
19
|
+
Requires-Dist: thefuzz
|
|
19
20
|
Requires-Dist: imagehash
|
|
20
21
|
Requires-Dist: requests
|
|
22
|
+
Requires-Dist: chroptiks
|
|
21
23
|
Requires-Dist: matplotlib
|
|
22
24
|
Requires-Dist: markdown
|
|
23
25
|
Requires-Dist: networkx
|
|
@@ -40,6 +42,7 @@ Requires-Dist: flask_cors
|
|
|
40
42
|
Requires-Dist: redis
|
|
41
43
|
Requires-Dist: psycopg2-binary
|
|
42
44
|
Requires-Dist: flask_sse
|
|
45
|
+
Requires-Dist: wikipedia
|
|
43
46
|
Provides-Extra: lite
|
|
44
47
|
Requires-Dist: anthropic; extra == "lite"
|
|
45
48
|
Requires-Dist: openai; extra == "lite"
|
|
@@ -54,6 +57,7 @@ Requires-Dist: chromadb; extra == "local"
|
|
|
54
57
|
Requires-Dist: diffusers; extra == "local"
|
|
55
58
|
Requires-Dist: nltk; extra == "local"
|
|
56
59
|
Requires-Dist: torch; extra == "local"
|
|
60
|
+
Requires-Dist: darts; extra == "local"
|
|
57
61
|
Provides-Extra: yap
|
|
58
62
|
Requires-Dist: pyaudio; extra == "yap"
|
|
59
63
|
Requires-Dist: gtts; extra == "yap"
|
|
@@ -76,6 +80,7 @@ Requires-Dist: chromadb; extra == "all"
|
|
|
76
80
|
Requires-Dist: diffusers; extra == "all"
|
|
77
81
|
Requires-Dist: nltk; extra == "all"
|
|
78
82
|
Requires-Dist: torch; extra == "all"
|
|
83
|
+
Requires-Dist: darts; extra == "all"
|
|
79
84
|
Requires-Dist: pyaudio; extra == "all"
|
|
80
85
|
Requires-Dist: gtts; extra == "all"
|
|
81
86
|
Requires-Dist: playsound==1.2.2; extra == "all"
|
|
@@ -118,18 +123,25 @@ Once installed, the following CLI tools will be available: `npcsh`, `guac`, `npc
|
|
|
118
123
|
|
|
119
124
|
|
|
120
125
|
- Get help with a task:
|
|
121
|
-
```
|
|
126
|
+
```bash
|
|
122
127
|
npcsh:🤖sibiji:gemini-2.5-flash>can you help me identify what process is listening on port 5337?
|
|
123
128
|
```
|
|
124
129
|
<p align="center">
|
|
125
130
|
<img src="https://raw.githubusercontent.com/npc-worldwide/npcsh/main/test_data/port5337.png" alt="example of running npcsh to check what processes are listening on port 5337", width=600>
|
|
126
131
|
</p>
|
|
127
|
-
|
|
132
|
+
|
|
133
|
+
- Edit files
|
|
134
|
+
```bash
|
|
135
|
+
npcsh>please read through the markdown files in the docs folder and suggest changes based on the current implementation in the src folder
|
|
136
|
+
```
|
|
128
137
|
|
|
129
138
|
- **Ask a Generic Question**
|
|
130
139
|
```bash
|
|
131
140
|
npcsh> has there ever been a better pasta shape than bucatini?
|
|
132
141
|
```
|
|
142
|
+
```
|
|
143
|
+
Ultimately, the "best" pasta shape depends on personal preference and the dish being prepared. Bucatini shines in specific contexts, but pasta lovers often appreciate a diverse range of shapes for their unique qualities and compatibilities with various sauces and ingredients. Each shape has its place in the culinary world, and trying different types can enhance the overall dining experience.
|
|
144
|
+
```
|
|
133
145
|
|
|
134
146
|
```
|
|
135
147
|
.Loaded .env file...
|
|
@@ -150,11 +162,11 @@ Once installed, the following CLI tools will be available: `npcsh`, `guac`, `npc
|
|
|
150
162
|
```
|
|
151
163
|
<p align="center">
|
|
152
164
|
<img src="https://raw.githubusercontent.com/npc-worldwide/npcsh/main/test_data/search_example.png" alt="example of search results", width=600>
|
|
153
|
-
|
|
165
|
+
</p>
|
|
154
166
|
|
|
155
167
|
- **Computer Use**
|
|
156
168
|
```bash
|
|
157
|
-
/plonk
|
|
169
|
+
/plonk 'find out the latest news on cnn'
|
|
158
170
|
```
|
|
159
171
|
|
|
160
172
|
- **Generate Image**
|
|
@@ -168,15 +180,16 @@ Once installed, the following CLI tools will be available: `npcsh`, `guac`, `npc
|
|
|
168
180
|
```bash
|
|
169
181
|
/roll 'generate a video of a hat riding a dog'
|
|
170
182
|
```
|
|
183
|
+
<!--
|
|
171
184
|
<p align="center">
|
|
172
185
|
<img src="https://raw.githubusercontent.com/npc-worldwide/npcsh/main/test_data/hat_video.mp4" alt="video of a hat riding a dog", width=250>
|
|
173
|
-
</p>
|
|
186
|
+
</p> -->
|
|
174
187
|
|
|
175
188
|
- **Serve an NPC Team**
|
|
176
189
|
```bash
|
|
177
190
|
/serve --port 5337 --cors='http://localhost:5137/'
|
|
178
191
|
```
|
|
179
|
-
- **Screenshot Analysis
|
|
192
|
+
- **Screenshot Analysis**: select an area on your screen and then send your question to the LLM
|
|
180
193
|
```bash
|
|
181
194
|
/ots
|
|
182
195
|
```
|
|
@@ -184,19 +197,21 @@ Once installed, the following CLI tools will be available: `npcsh`, `guac`, `npc
|
|
|
184
197
|
|
|
185
198
|
# Macros
|
|
186
199
|
- activated by invoking `/<command> ...` in `npcsh`, macros can be called in bash or through the `npc` CLI. In our examples, we provide both `npcsh` calls as well as bash calls with the `npc` cli where relevant. For converting any `/<command>` in `npcsh` to a bash version, replace the `/` with `npc ` and the macro command will be invoked as a positional argument. Some, like breathe, flush,
|
|
187
|
-
|
|
188
|
-
- ## TL; DR:
|
|
200
|
+
|
|
189
201
|
- `/alicanto` - Conduct deep research with multiple perspectives, identifying gold insights and cliff warnings
|
|
190
202
|
- `/brainblast` - Execute an advanced chunked search on command history
|
|
191
203
|
- `/breathe` - Condense context on a regular cadence
|
|
192
204
|
- `/compile` - Compile NPC profiles
|
|
205
|
+
- `/corca` - Enter the Corca MCP-powered agentic shell. Usage: /corca [--mcp-server-path path]
|
|
193
206
|
- `/flush` - Flush the last N messages
|
|
194
207
|
- `/guac` - Enter guac mode
|
|
195
208
|
- `/help` - Show help for commands, NPCs, or Jinxs. Usage: /help
|
|
196
209
|
- `/init` - Initialize NPC project
|
|
197
210
|
- `/jinxs` - Show available jinxs for the current NPC/Team
|
|
211
|
+
- `/npc-studio` - Start npc studio
|
|
198
212
|
- `/ots` - Take screenshot and analyze with vision model
|
|
199
|
-
- `/plan` - Execute a plan command
|
|
213
|
+
- `/plan` - Execute a plan command
|
|
214
|
+
- `/plonk` - Use vision model to interact with GUI. Usage: /plonk <task description>
|
|
200
215
|
- `/pti` - Use pardon-the-interruption mode to interact with reasoning model LLM
|
|
201
216
|
- `/rag` - Execute a RAG command using ChromaDB embeddings with optional file input (-f/--file)
|
|
202
217
|
- `/roll` - generate a video with video generation model
|
|
@@ -211,13 +226,13 @@ Once installed, the following CLI tools will be available: `npcsh`, `guac`, `npc
|
|
|
211
226
|
- `/wander` - A method for LLMs to think on a problem by switching between states of high temperature and low temperature
|
|
212
227
|
- `/yap` - Enter voice chat (yap) mode
|
|
213
228
|
|
|
214
|
-
## Common Command-Line Flags
|
|
229
|
+
## Common Command-Line Flags:
|
|
215
230
|
|
|
216
231
|
```
|
|
217
232
|
Flag Shorthand | Flag Shorthand | Flag Shorthand | Flag Shorthand
|
|
218
233
|
------------------------------ | ------------------------------ | ------------------------------ | ------------------------------
|
|
219
234
|
--attachments (-a) | --height (-h) | --num_npcs (-num_n) | --team (-tea)
|
|
220
|
-
--config_dir (-con) | --igmodel (-igm) | --output_file (-o) | --temperature (-
|
|
235
|
+
--config_dir (-con) | --igmodel (-igm) | --output_file (-o) | --temperature (-t)
|
|
221
236
|
--cors (-cor) | --igprovider (-igp) | --plots_dir (-pl) | --top_k
|
|
222
237
|
--creativity (-cr) | --lang (-l) | --port (-po) | --top_p
|
|
223
238
|
--depth (-d) | --max_tokens (-ma) | --provider (-pr) | --vmodel (-vm)
|
|
@@ -228,368 +243,19 @@ Once installed, the following CLI tools will be available: `npcsh`, `guac`, `npc
|
|
|
228
243
|
```
|
|
229
244
|
'
|
|
230
245
|
|
|
231
|
-
- ## alicanto: a research exploration agent flow.
|
|
232
|
-
|
|
233
|
-
<p align="center"><a href ="https://github.com/npc-worldwide/npcsh/blob/main/docs/alicanto.md">
|
|
234
|
-
<img src="https://raw.githubusercontent.com/npc-worldwide/npcsh/main/npcsh/npc_team/alicanto.png" alt="logo for deep research", width=250></a>
|
|
235
|
-
</p>
|
|
236
|
-
|
|
237
|
-
- Examples:
|
|
238
|
-
```bash
|
|
239
|
-
# npcsh
|
|
240
|
-
/alicanto "What are the implications of quantum computing for cybersecurity?"
|
|
241
|
-
/alicanto "How might climate change impact global food security?" --num-npcs 8 --depth 5
|
|
242
|
-
```
|
|
243
|
-
|
|
244
|
-
```bash
|
|
245
|
-
# bash
|
|
246
|
-
npc alicanto "What ethical considerations should guide AI development?" --max_facts_per_chain 0.5 --max_thematic_groups 3 --max_criticisms_per_group 3 max_conceptual_combinations 3 max_experiments 10
|
|
247
|
-
|
|
248
|
-
npc alicanto "What is the future of remote work?" --format report
|
|
249
|
-
```
|
|
250
|
-
- ## Brainblast: searching through past messages:
|
|
251
|
-
```bash
|
|
252
|
-
# npcsh
|
|
253
|
-
/brainblast 'subtle summer winds' --top_k 10
|
|
254
|
-
```
|
|
255
|
-
```bash
|
|
256
|
-
# bash
|
|
257
|
-
npc brainblast 'python dictionaries'
|
|
258
|
-
```
|
|
259
|
-
- ## Breathe: Condense conversation context (shell only):
|
|
260
|
-
```bash
|
|
261
|
-
# npcsh
|
|
262
|
-
/breathe
|
|
263
|
-
/breathe -p ollama -m qwen3:latest
|
|
264
|
-
```
|
|
265
|
-
- ## Compile: render npcs for use without re-loading npcsh
|
|
266
|
-
```bash
|
|
267
|
-
# npcsh
|
|
268
|
-
/compile /path/to/npc
|
|
269
|
-
```
|
|
270
|
-
- ## flush: flush context (shell only):
|
|
271
|
-
```bash
|
|
272
|
-
/flush
|
|
273
|
-
```
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
- ## `guac`
|
|
277
|
-
|
|
278
|
-
<p align="center"><a href ="https://github.com/npc-worldwide/npcsh/blob/main/docs/guac.md">
|
|
279
|
-
<img src="https://raw.githubusercontent.com/npc-worldwide/npcsh/main/npcsh/npc_team/guac.png" alt="npcsh logo of a solarpunk sign", width=250></a>
|
|
280
|
-
</p>
|
|
281
|
-
|
|
282
|
-
- a replacement shell for interpreters like python/r/node/julia with an avocado input marker 🥑 that brings a pomodoro-like approach to interactive coding.
|
|
283
|
-
- Simulation:
|
|
284
|
-
`🥑 Make a markov chain simulation of a random walk in 2D space with 1000 steps and visualize`
|
|
285
|
-
```
|
|
286
|
-
# Generated python code:
|
|
287
|
-
import numpy as np
|
|
288
|
-
import matplotlib.pyplot as plt
|
|
289
|
-
|
|
290
|
-
# Number of steps
|
|
291
|
-
n_steps = 1000
|
|
292
|
-
|
|
293
|
-
# Possible moves: up, down, left, right
|
|
294
|
-
moves = np.array([[0, 1], [0, -1], [1, 0], [-1, 0]])
|
|
295
|
-
|
|
296
|
-
# Initialize position array
|
|
297
|
-
positions = np.zeros((n_steps+1, 2), dtype=int)
|
|
298
|
-
|
|
299
|
-
# Generate random moves
|
|
300
|
-
for i in range(1, n_steps+1):
|
|
301
|
-
step = moves[np.random.choice(4)]
|
|
302
|
-
positions[i] = positions[i-1] + step
|
|
303
|
-
|
|
304
|
-
# Plot the random walk
|
|
305
|
-
plt.figure(figsize=(8, 8))
|
|
306
|
-
plt.plot(positions[:, 0], positions[:, 1], lw=1)
|
|
307
|
-
plt.scatter([positions[0, 0]], [positions[0, 1]], color='green', label='Start')
|
|
308
|
-
plt.scatter([positions[-1, 0]], [positions[-1, 1]], color='red', label='End')
|
|
309
|
-
plt.title('2D Random Walk - 1000 Steps (Markov Chain)')
|
|
310
|
-
plt.xlabel('X Position')
|
|
311
|
-
plt.ylabel('Y Position')
|
|
312
|
-
plt.legend()
|
|
313
|
-
plt.grid(True)
|
|
314
|
-
plt.axis('equal')
|
|
315
|
-
plt.show()
|
|
316
|
-
# Generated code executed successfully
|
|
317
|
-
|
|
318
|
-
```
|
|
319
|
-
<p align="center">
|
|
320
|
-
<img src="https://raw.githubusercontent.com/npc-worldwide/npcsh/main/test_data/markov_chain.png" alt="markov_chain_figure", width=250>
|
|
321
|
-
</p>
|
|
322
|
-
|
|
323
|
-
Access the variables created in the code:
|
|
324
|
-
`🥑 print(positions)`
|
|
325
|
-
```
|
|
326
|
-
[[ 0 0]
|
|
327
|
-
[ 0 -1]
|
|
328
|
-
[ -1 -1]
|
|
329
|
-
...
|
|
330
|
-
[ 29 -23]
|
|
331
|
-
[ 28 -23]
|
|
332
|
-
[ 27 -23]]
|
|
333
|
-
```
|
|
334
|
-
|
|
335
|
-
- Run a python script:
|
|
336
|
-
`🥑 run file.py`
|
|
337
|
-
- Refresh:
|
|
338
|
-
`🥑 /refresh`
|
|
339
|
-
- Show current variables:
|
|
340
|
-
`🥑 /show`
|
|
341
|
-
|
|
342
|
-
A guac session progresses through a series of stages, each of equal length. Each stage adjusts the emoji input prompt. Once the stages have passed, it is time to refresh. Stage 1: `🥑`, Stage 2: `🥑🔪` Stage 3: `🥑🥣` Stage:4 `🥑🥣🧂`, `Stage 5: 🥘 TIME TO REFRESH`. At stage 5, the user is reminded to refresh with the /refresh macro. This will evaluate the session so farand suggest and implement new functions or automations that will aid in future sessions, with the ultimate approval of the user.
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
- ## help:/ Show help for commands, NPCs, or Jinxs.
|
|
346
|
-
```bash
|
|
347
|
-
/help
|
|
348
|
-
```
|
|
349
|
-
- ## init - Initialize NPC project
|
|
350
|
-
- ## jinxs : show available jinxs
|
|
351
|
-
- ## ots: Over-the-shoulder screen shot analysis
|
|
352
|
-
- Screenshot analysis:
|
|
353
|
-
```bash
|
|
354
|
-
#npcsh
|
|
355
|
-
/ots
|
|
356
|
-
/ots output_filename =...
|
|
357
|
-
```
|
|
358
|
-
```bash
|
|
359
|
-
#bash
|
|
360
|
-
npc ots ...
|
|
361
|
-
```
|
|
362
|
-
- ## `plan`: set up cron jobs:
|
|
363
|
-
```bash
|
|
364
|
-
# npcsh
|
|
365
|
-
/plan 'a description of a cron job to implement' -m gemma3:27b -p ollama
|
|
366
|
-
```
|
|
367
|
-
```bash
|
|
368
|
-
# bash
|
|
369
|
-
npc plan
|
|
370
|
-
```
|
|
371
|
-
|
|
372
|
-
- ## `plonk`: Computer use:
|
|
373
|
-
```bash
|
|
374
|
-
# npcsh
|
|
375
|
-
/plonk -n 'npc_name' -sp 'task for plonk to carry out '
|
|
376
|
-
|
|
377
|
-
#bash
|
|
378
|
-
npc plonk
|
|
379
|
-
```
|
|
380
|
-
- ## `pti`: a reasoning REPL loop with interruptions
|
|
381
|
-
|
|
382
|
-
```npcsh
|
|
383
|
-
/pti -n frederic -m qwen3:latest -p ollama
|
|
384
|
-
```
|
|
385
|
-
|
|
386
|
-
Or from the bash cmd line:
|
|
387
|
-
```bash
|
|
388
|
-
pti
|
|
389
|
-
```
|
|
390
|
-
<p align="center"><a href ="https://github.com/npc-worldwide/npcsh/blob/main/docs/pti.md">
|
|
391
|
-
<img src="https://raw.githubusercontent.com/npc-worldwide/npcsh/main/npcsh/npc_team/frederic4.png" alt="npcsh logo of frederic the bear and the pti logo", width=250></a>
|
|
392
|
-
</p>
|
|
393
|
-
|
|
394
|
-
- ## `rag`: embedding search through chroma db, optional file input
|
|
395
|
-
- ## `roll`: your video generation assistant
|
|
396
|
-
-
|
|
397
|
-
```npcsh
|
|
398
|
-
/roll --provider ollama --model llama3
|
|
399
|
-
```
|
|
400
|
-
|
|
401
|
-
- ## sample: one-shot sampling from LLMs with specific parameters
|
|
402
|
-
```bash
|
|
403
|
-
# npcsh
|
|
404
|
-
/sample 'prompt'
|
|
405
|
-
/sample -m gemini-1.5-flash "Summarize the plot of 'The Matrix' in three sentences."
|
|
406
|
-
|
|
407
|
-
/sample --model claude-3-5-haiku-latest "Translate 'good morning' to Japanese."
|
|
408
|
-
|
|
409
|
-
/sample model=qwen3:latest "tell me about the last time you went shopping."
|
|
410
|
-
|
|
411
|
-
|
|
412
|
-
```
|
|
413
|
-
```bash
|
|
414
|
-
# bash
|
|
415
|
-
npc sample -p ollama -m gemma3:12b --temp 1.8 --top_k 50 "Write a haiku about the command line."
|
|
416
|
-
|
|
417
|
-
npc sample model=gpt-4o-mini "What are the primary colors?" --provider openai
|
|
418
|
-
```
|
|
419
|
-
|
|
420
|
-
- ## search: use an internet search provider
|
|
421
|
-
```npcsh
|
|
422
|
-
/search -sp perplexity 'cal bears football schedule'
|
|
423
|
-
/search --sprovider duckduckgo 'beef tongue'
|
|
424
|
-
# Other search providers could be added, but we have only integrated duckduckgo and perplexity for the moment.
|
|
425
|
-
```
|
|
426
|
-
|
|
427
|
-
```bash
|
|
428
|
-
npc search 'when is the moon gonna go away from the earth'
|
|
429
|
-
```
|
|
430
|
-
|
|
431
|
-
|
|
432
|
-
- ## serve: serve an npc team
|
|
433
|
-
```bash
|
|
434
|
-
/serve
|
|
435
|
-
/serve ....
|
|
436
|
-
# Other search providers could be added, but we have only integrated duckduckgo and perplexity for the moment.
|
|
437
|
-
```
|
|
438
|
-
|
|
439
|
-
```bash
|
|
440
|
-
npc serve
|
|
441
|
-
```
|
|
442
|
-
|
|
443
|
-
- ## set: change current model, env params
|
|
444
|
-
```bash
|
|
445
|
-
/set model ...
|
|
446
|
-
/set provider ...
|
|
447
|
-
/set NPCSH_API_URL https://localhost:1937
|
|
448
|
-
```
|
|
449
|
-
|
|
450
|
-
```bash
|
|
451
|
-
npc set ...
|
|
452
|
-
```
|
|
453
|
-
- ## sleep: prune and evolve the current knowledge graph
|
|
454
|
-
```bash
|
|
455
|
-
/sleep
|
|
456
|
-
/sleep --dream
|
|
457
|
-
/sleep --ops link_facts,deepen
|
|
458
|
-
```
|
|
459
|
-
|
|
460
|
-
```bash
|
|
461
|
-
npc sleep
|
|
462
|
-
```
|
|
463
|
-
- ## `spool`
|
|
464
|
-
<p align="center"><a href ="https://github.com/npc-worldwide/npcsh/blob/main/docs/spool.md">
|
|
465
|
-
<img src="https://raw.githubusercontent.com/npc-worldwide/npcsh/main/npcsh/npc_team/spool.png" alt="logo for spool", width=250></a>
|
|
466
|
-
</p>
|
|
467
|
-
|
|
468
|
-
- Enter chat loop with isolated context, attachments, specified models/providers:
|
|
469
|
-
```npcsh
|
|
470
|
-
/spool -n <npc_name>
|
|
471
|
-
/spool --attachments ./test_data/port5337.png,./test_data/yuan2004.pdf,./test_data/books.csv
|
|
472
|
-
/spool --provider ollama --model llama3
|
|
473
|
-
/spool -p deepseek -m deepseek-reasoner
|
|
474
|
-
/spool -n alicanto
|
|
475
|
-
```
|
|
476
|
-
|
|
477
|
-
|
|
478
|
-
|
|
479
|
-
- ## Trigger: schedule listeners, daemons
|
|
480
|
-
```bash
|
|
481
|
-
/trigger 'a description of a trigger to implement with system daemons/file system listeners.' -m gemma3:27b -p ollama
|
|
482
|
-
```
|
|
483
|
-
```bash
|
|
484
|
-
npc trigger
|
|
485
|
-
```
|
|
486
|
-
|
|
487
|
-
|
|
488
|
-
|
|
489
|
-
|
|
490
|
-
|
|
491
|
-
|
|
492
|
-
- ## Vixynt: Image generation and editing:
|
|
493
|
-
```bash
|
|
494
|
-
npcsh
|
|
495
|
-
/vixynt 'an image of a dog eating a hat'
|
|
496
|
-
/vixynt --output_file ~/Desktop/dragon.png "A terrifying dragon"
|
|
497
|
-
/vixynt "A photorealistic portrait of a cat wearing a wizard hat in the dungeon of the master and margarita" -w 1024. height=1024
|
|
498
|
-
/vixynt -igp ollama --igmodel Qwen/QwenImage --output_file /tmp/sub.png width=1024 height=512 "A detailed steampunk submarine exploring a vibrant coral reef, wide aspect ratio"
|
|
499
|
-
```
|
|
500
|
-
|
|
501
|
-
```bash
|
|
502
|
-
# bash
|
|
503
|
-
npc vixynt --attachments ./test_data/rabbit.PNG "Turn this rabbit into a fierce warrior in a snowy winter scene" -igp openai -igm gpt-image
|
|
504
|
-
npc vixynt --igmodel CompVis/stable-diffusion-v1-4 --igprovider diffusers "sticker of a red tree"
|
|
505
|
-
```
|
|
506
|
-
|
|
507
|
-
|
|
508
|
-
|
|
509
|
-
|
|
510
|
-
|
|
511
|
-
- ## `wander`: daydreaming for LLMs
|
|
512
|
-
|
|
513
|
-
<p align="center"><a href ="https://github.com/npc-worldwide/npcsh/blob/main/docs/wander.md">
|
|
514
|
-
<img src="https://raw.githubusercontent.com/npc-worldwide/npcsh/main/npcsh/npc_team/kadiefa.png" alt="logo for wander", width=250></a>
|
|
515
|
-
</p>
|
|
516
|
-
A system for thinking outside of the box. From our testing, it appears gpt-4o-mini and gpt-series models in general appear to wander the most through various languages and ideas with high temperatures. Gemini models and many llama ones appear more stable despite high temps. Thinking models in general appear to be worse at this task.
|
|
517
|
-
|
|
518
|
-
- Wander with an auto-generated environment
|
|
519
|
-
```
|
|
520
|
-
npc --model "gemini-2.0-flash" --provider "gemini" wander "how does the bar of a galaxy influence the the surrounding IGM?" \
|
|
521
|
-
n-high-temp-streams=10 \
|
|
522
|
-
high-temp=1.95 \
|
|
523
|
-
low-temp=0.4 \
|
|
524
|
-
sample-rate=0.5 \
|
|
525
|
-
interruption-likelihood=1
|
|
526
|
-
```
|
|
527
|
-
- Specify a custom environment
|
|
528
|
-
```
|
|
529
|
-
npc --model "gpt-4o-mini" --provider "openai" wander "how does the goos-hanchen effect impact neutron scattering?" \
|
|
530
|
-
environment='a ships library in the south.' \
|
|
531
|
-
num-events=3 \
|
|
532
|
-
n-high-temp-streams=10 \
|
|
533
|
-
high-temp=1.95 \
|
|
534
|
-
low-temp=0.4 \
|
|
535
|
-
sample-rate=0.5 \
|
|
536
|
-
interruption-likelihood=1
|
|
537
|
-
```
|
|
538
|
-
- Control event generation
|
|
539
|
-
```
|
|
540
|
-
npc wander "what is the goos hanchen effect and does it affect water refraction?" \
|
|
541
|
-
--provider "ollama" \
|
|
542
|
-
--model "deepseek-r1:32b" \
|
|
543
|
-
environment="a vast, dark ocean ." \
|
|
544
|
-
interruption-likelihood=.1
|
|
545
|
-
```
|
|
546
|
-
|
|
547
|
-
- ## `yap`: an agentic voice control loop
|
|
548
|
-
|
|
549
|
-
|
|
550
|
-
<p align="center"><a href ="https://github.com/npc-worldwide/npcsh/blob/main/docs/yap.md">
|
|
551
|
-
<img src="https://raw.githubusercontent.com/npc-worldwide/npcsh/main/npcsh/npc_team/yap.png" alt="logo for yap ", width=250></a>
|
|
552
|
-
</p>
|
|
553
|
-
|
|
554
|
-
- an agentic voice control loop with a specified agent. When launching `yap`, the user enters the typical `npcsh` agentic loop except that the system is waiting for either text or audio input.
|
|
555
|
-
- voice chat:
|
|
556
|
-
```bash
|
|
557
|
-
# npcsh
|
|
558
|
-
/yap
|
|
559
|
-
```
|
|
560
|
-
```bash
|
|
561
|
-
# bash
|
|
562
|
-
yap
|
|
563
|
-
npc yap
|
|
564
|
-
```
|
|
565
|
-
- Show available Jinja Execution Templates:
|
|
566
|
-
```bash
|
|
567
|
-
# npcsh
|
|
568
|
-
/jinxs
|
|
569
|
-
```
|
|
570
|
-
```bash
|
|
571
|
-
# bash
|
|
572
|
-
npc jinxs
|
|
573
|
-
```
|
|
574
|
-
|
|
575
|
-
|
|
576
|
-
|
|
577
|
-
## Inference Capabilities
|
|
578
|
-
- `npcsh` works with local and enterprise LLM providers through its LiteLLM integration, allowing users to run inference from Ollama, LMStudio, OpenAI, Anthropic, Gemini, and Deepseek, making it a versatile tool for both simple commands and sophisticated AI-driven tasks.
|
|
579
|
-
|
|
580
246
|
## Read the Docs
|
|
247
|
+
To see more about how to use the macros and modes in the NPC Shell, read the docs at [npc-shell.readthedocs.io](https://npc-shell.readthedocs.io/en/latest/)
|
|
581
248
|
|
|
582
|
-
Read the docs at [npcsh.readthedocs.io](https://npcsh.readthedocs.io/en/latest/)
|
|
583
249
|
|
|
250
|
+
## Inference Capabilities
|
|
251
|
+
- `npcsh` works with local and enterprise LLM providers through its LiteLLM integration, allowing users to run inference from Ollama, LMStudio, vLLM, MLX, OpenAI, Anthropic, Gemini, and Deepseek, making it a versatile tool for both simple commands and sophisticated AI-driven tasks.
|
|
584
252
|
|
|
585
253
|
## NPC Studio
|
|
586
254
|
There is a graphical user interface that makes use of the NPC Toolkit through the NPC Studio. See the open source code for NPC Studio [here](https://github.com/npc-worldwide/npc-studio). Download the executables at [our website](https://enpisi.com/npc-studio).
|
|
587
255
|
|
|
588
|
-
|
|
589
256
|
## Mailing List
|
|
590
257
|
Interested to stay in the loop and to hear the latest and greatest about `npcpy`, `npcsh`, and NPC Studio? Be sure to sign up for the [newsletter](https://forms.gle/n1NzQmwjsV4xv1B2A)!
|
|
591
258
|
|
|
592
|
-
|
|
593
259
|
## Support
|
|
594
260
|
If you appreciate the work here, [consider supporting NPC Worldwide with a monthly donation](https://buymeacoffee.com/npcworldwide), [buying NPC-WW themed merch](https://enpisi.com/shop), or hiring us to help you explore how to use the NPC Toolkit and AI tools to help your business or research team, please reach out to info@npcworldwi.de .
|
|
595
261
|
|
|
@@ -706,7 +372,7 @@ python-tkinter (pyautogui)
|
|
|
706
372
|
</details>
|
|
707
373
|
|
|
708
374
|
## Startup Configuration and Project Structure
|
|
709
|
-
After `npcsh` has been pip installed, `npcsh`, `guac`, `pti`, `spool`, `yap` and the `npc` CLI can be used as command line tools. To initialize these correctly, first start by starting the NPC shell:
|
|
375
|
+
After `npcsh` has been pip installed, `npcsh`, `corca`, `guac`, `pti`, `spool`, `yap` and the `npc` CLI can be used as command line tools. To initialize these correctly, first start by starting the NPC shell:
|
|
710
376
|
```bash
|
|
711
377
|
npcsh
|
|
712
378
|
```
|
|
@@ -751,6 +417,10 @@ export PERPLEXITY_API_KEY='your_perplexity_key'
|
|
|
751
417
|
├── npc_team/ # Global NPCs
|
|
752
418
|
│ ├── jinxs/ # Global tools
|
|
753
419
|
│ └── assembly_lines/ # Workflow pipelines
|
|
420
|
+
│ └── example.npc # globally available npc
|
|
421
|
+
│ └── global.ctx # global context file
|
|
422
|
+
|
|
423
|
+
|
|
754
424
|
|
|
755
425
|
```
|
|
756
426
|
For cases where you wish to set up a project specific set of NPCs, jinxs, and assembly lines, add a `npc_team` directory to your project and `npcsh` should be able to pick up on its presence, like so:
|
|
@@ -758,8 +428,8 @@ For cases where you wish to set up a project specific set of NPCs, jinxs, and as
|
|
|
758
428
|
./npc_team/ # Project-specific NPCs
|
|
759
429
|
├── jinxs/ # Project jinxs #example jinx next
|
|
760
430
|
│ └── example.jinx
|
|
761
|
-
└── assembly_lines/ #
|
|
762
|
-
└── example.
|
|
431
|
+
└── assembly_lines/ # Agentic Workflows
|
|
432
|
+
└── example.line
|
|
763
433
|
└── models/ # Project workflows
|
|
764
434
|
└── example.model
|
|
765
435
|
└── example1.npc # Example NPC
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
npcsh/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
|
2
|
+
npcsh/_state.py,sha256=gWkFSlKWq-cX8UKVt3aiyHj4ZzZQBRUkOsIjAxl3j7w,89864
|
|
3
|
+
npcsh/alicanto.py,sha256=-muGqd0O2m8xcFBctEavSEizWbQmzuPSdcT-3YqYBhY,45043
|
|
4
|
+
npcsh/corca.py,sha256=2KoYoG1hwbUmMI2YlQ1RrrfkW5bXAYz2EIPRNMMTt1g,31569
|
|
5
|
+
npcsh/guac.py,sha256=7DoRzEY4HrHGDzxehLJUBfM7C6rbNLP71Mnn28D6Ylo,65141
|
|
6
|
+
npcsh/mcp_helpers.py,sha256=Ktd2yXuBnLL2P7OMalgGLj84PXJSzaucjqmJVvWx6HA,12723
|
|
7
|
+
npcsh/mcp_server.py,sha256=htQBSN6y3g3zVCy2ADsdBuQT9PhqaOCSQG_RS9IinWI,5853
|
|
8
|
+
npcsh/npc.py,sha256=elJ494nl_pv8iDrDvBFAlmFvBdci0_CZBjZwbOjVj0c,9113
|
|
9
|
+
npcsh/npcsh.py,sha256=rGcl3h6BMGPwv0fJhA_ekCcJSA1B5s7tGyHKV73fJ5s,8253
|
|
10
|
+
npcsh/plonk.py,sha256=7w7J2bht5QXOyV2UK045nAPDmrSrTGLX-sh56KQ3-k0,14653
|
|
11
|
+
npcsh/pti.py,sha256=UciiiH2Kz4ERQFy0-FX6BQEU2VxYQEUril-_Cvj76Y0,7853
|
|
12
|
+
npcsh/routes.py,sha256=kgpWtCV71sm0JjfJ5kNa3AqIijIknJJYxJV9Do6HY7M,46574
|
|
13
|
+
npcsh/spool.py,sha256=r0-oXkrNDbxQ5ZNHr1vSJcdmVj3jdWbz7qYcEDoSrj8,10354
|
|
14
|
+
npcsh/wander.py,sha256=BiN6eYyFnEsFzo8MFLRkdZ8xS9sTKkQpjiCcy9chMcc,23225
|
|
15
|
+
npcsh/yap.py,sha256=ipkY3uMDw8gNrPSZ9qJFWVQ_fXtLmQ2oz_6_WZt2hew,21097
|
|
16
|
+
npcsh-1.0.17.dist-info/licenses/LICENSE,sha256=IKBvAECHP-aCiJtE4cHGCE5Yl0tozYz02PomGeWS3y4,1070
|
|
17
|
+
npcsh-1.0.17.dist-info/METADATA,sha256=VOtULcSi1iYScaQRdKEH97IyFKPtrW_ffYurbJm6HQo,20011
|
|
18
|
+
npcsh-1.0.17.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
|
|
19
|
+
npcsh-1.0.17.dist-info/entry_points.txt,sha256=S5yIuGm8ZXQ4siHYgN5gs0J7bxgobSEULXf8L5HaW5o,206
|
|
20
|
+
npcsh-1.0.17.dist-info/top_level.txt,sha256=kHSNgKMCkfjV95-DH0YSp1LLBi0HXdF3w57j7MQON3E,6
|
|
21
|
+
npcsh-1.0.17.dist-info/RECORD,,
|