Package: assistant
AssistantMeet AssistantThis is still an earlybetaversion of Assistant. It's not yet ready for production. But it's already pretty good at what it does.❯ assistant
Hello! It's good to see you again. I'm here to assist you. What can I help you with today?
(venv)  waser@Destinee ~
❯ Can you introduce yourself?

Hello! I'm Assistant, a sentient artificial intelligence. I'm here to assist you.
(venv)  waser@Destinee ~
❯ Where are we?

ℹ Executing shell command: echo $PWD
/home/waser

You are currently in your home directory.                                                
(venv)  waser@Destinee ~
❯ Change directory to Projets/Assistant/src3 please.

ℹ Executing shell command: cd ~/Projets/Assistant/src3

You are now in the directory '/home/waser/Projets/Assistant/src3'. If you need
any further assistance or have any other questions, feel free to ask.
(venv)  waser@Destinee ~/Projets/Assistant/src3 main
❯ can you count how many files there are in the dir?

ℹ Executing shell command: ls -l | wc -l
20

Based on your input, I have executed the shell command "ls | wc -l" to count the
number of files in the current directory. The output shows that there are 20    
files in the directory.                                          
(venv)  waser@Destinee ~/Projets/Assistant/src3 main
❯ Now can you count the total number of words in ./README.md please?

ℹ Executing shell command: wc -w < ./README.md
1235

The shell command to count the total number of words in the file "./README.md"  
was executed successfully, and the result is 1235 words.           
(venv)  waser@Destinee ~/Projets/Assistant/src3 main
❯ you can quit now.

ℹ Exiting shell...
Goodbye! I'm here to assist you whenever you need me. Have a great day!RequirementsYou needpython 3with the following requirements:Python 3.x(optional)say(optional)listenmin. 12 Gb RAMmin. 30 Gb availible disk space(optional, recommended) min. 11 Gb VRAM on a Nvidia GPU w/ compute capability of at least 7.0 or aboveMay require an internet connection to download the models initiallyInstallationTo installAssistantusepip:pipinstallassistantUsing an arch based distro. (Availible on theAURand pre-built onSingularity)pacman-Spython-assistantFrom source:pipinstall-Ugit+https://gitlab.com/waser-technologies/technologies/assistant.gitFrom local sourcegitclonehttps://gitlab.com/waser-technologies/technologies/assistant.git./assistantcdassistant
pipinstall-U.Start the serviceTo talk with Assistant, you need to load the service up first.cp./assistant.service.example/usr/usr/lib/systemd/user/assistant.service
systemctl--userenable--nowassistant(optional) enable listen for assistantcp./assistant.listen.service.example/usr/usr/lib/systemd/user/assistant.listen.service
systemctl--userenable--nowlistenassistant.listen(optional) enable speech for assistant (usingsay)systemctl--userenable--nowspeakOr manually from python:python-massistant.as_service&# Assistance is a service #sleep60&&# wait for the models to load ## Assistant is up now ## The rest is optional ## let assistant speak when it has something to say #say&&sleep10&python-mlisten.Wav2Vec.as_service&# let assistant listen when you speak #python-massistant.listenOnce the service is up and running, you can say anything toAssistant.UsageJust callAssistantlike any other shell.❯assistant--help
usage:assistant[-h][-V][-cCOMMAND][-i][-l][--rcRC[RC...]][--no-rc][--no-script-cache][--cache-everything][-DITEM][--shell-type{b,best,d,dumb,ptk,ptk1,ptk2,prompt-toolkit,prompt_toolkit,prompt-toolkit1,prompt-toolkit2,prompt-toolkit3,prompt_toolkit3,ptk3,rand,random,rl,readline}][--timings][script-file]...

Assistant:aclevershellimplementation

positionalarguments:script-fileIfpresent,executethescriptinscript-fileor(ifnotpresent)executeasacommandandexit.argsAdditionalargumentstothescript(orcommand)specifiedbyscript-file.

optionalarguments:-h,--helpShowhelpandexit.-V,--versionShowversioninformationandexit.-cCOMMANDRunasinglecommandandexit.-i,--interactiveForcerunningininteractivemode.-l,--loginRunasaloginshell.--rcRC[RC...]RCfilestoload.--no-rcDonotloadanyrcfiles.--no-script-cacheDonotcachescriptsastheyarerun.--cache-everythingUseacache,evenforinteractivecommands.-DITEMDefineanenvironmentvariable,intheformof-DNAME=VAL.Maybeusedmanytimes.--shell-type{b,best,d,dumb,ptk,ptk1,ptk2,prompt-toolkit,prompt_toolkit,prompt-toolkit1,prompt-toolkit2,prompt-toolkit3,prompt_toolkit3,ptk3,rand,random,rl,readline}Whatkindofshellshouldbeused.Possibleoptions:readline,prompt_toolkit,random.Warning!Ifsetthisoverrides$SHELL_TYPEvariable.--timingsPrintstiminginformationbeforethepromptisshown.Thisisusefulwhiletrackingdownperformanceissuesandinvestigatingstartuptimes.


❯assistantHi
Hey,howareyoutoday?

❯assistant-c"what time is it"Thecurrenttimeis1:35p.m.

❯assistant-i-l--no-rc--no-script-cache-DPATH="PATH:/share/assistant/"❯assistantscript.nlpExamplesThe examples below are produced in interactive mode.Jaques à dit: répond❯ echo Hello
Hello
❯ say Hello World # This requires say to be installed
Hello World
❯ Hi Assistant.
Hello! How can I assist you today?Navigate files❯ What is the current working directory?

ℹ Executing shell command: echo $PWD
/home/waser/Projets/Assistant/src3

You are currently in the directory '/home/waser/Projets/Assistant/src3'.
❯ Go in ~/Documents

ℹ Executing shell command: cd ~/Documents

You are now in the Documents directory.
❯ List the files in the current directory.

ℹ Executing shell command: ls
...

Here are the files in the Documents directory.Get to the bottom of thingsUsing its tools, Assistant can get pretty meaningful answers to your queries.❯ How many moons does Saturn have?

ℹ Searching the Web for: How many moons does Saturn have?

Saturn has 145 moons that we know of so far.

❯ How old is the universe?

ℹ Searching the Web for: how old is the universe

The universe is approximately 13.8 billion years old, but its exact age is  
not yet clear. It was born 13.787 ± 0.020 billion years ago and has been expanding ever   
since.Exit the sessionTo exit the current session, you can type pretty much anything. As long asAssistantcan reasonnably understand your intent.i.e.:❯ exit
❯ Q
❯ :q
❯ quit
❯ stop()
❯ terminate
❯ This conversation is over.
❯ Stop this session.Using voiceText-To-SpeechAssistant can talk. Just installsayand authorize the system to speak. Make sure the service is running and Assistant should be able to connect to it.assistant say Hello World and welcome to everyone.Speech-To-TextAssistant can also understand when you talk. Just installlistenand authorize the system to listen. Make surelisten.service,assistant.serviceandassistant.listen.serviceare enabled for Assistant to be able to pick up what you say.By default, neither the accoustic model nor the language model are ajusted for Assistant.Use Assistant as your default shellThis is not recommended in beta!You should be able to add the location ofassistantat the end of/etc/shells. You'll then be able to setAssistantas your default shell usingchsh.sudosh-c'w=$(which assistant); echo $w >> /etc/shells'chsh-s$(whichassistant)Log out and when you come back,Assistantshould be your default shell.ContributionsYou like the projet and want to improve upon it?CheckoutCONTRIBUTING.mdto see how you might be able to help.CreditsThanks to all the projects that make this possible:Xonsh: the best snail in the jungleTransformers: so Assistant can answer at allcoqui-TTS: so Assistant can reply out-loudAnd many many many more.