URSA - The Universal Research and Scientific Agent
The flexible agentic workflow for accelerating scientific tasks. Composes information flow between agents for planning, code writing and execution, and online research to solve complex problems.
The original ArXiv paper is here.
Documentation
Detailed documentation including:
- Installation
- Getting Started Guides
- Configuration
- ... and more
are located at: URSA Documentation
Installation
URSA is published on PyPI as ursa-ai and supports Python 3.11 or newer.
You can install it with uv or pip; uv is recommended for new projects.
Documentation and examples
The MkDocs documentation in docs/ is organized around installation, getting started, configuration, persistence, agents, best practices, and reference material. The examples/ folder demonstrates practical workflows and ways to pass results from one agent to another.
Command Line Usage
You can install ursa as a command line app with pip install; or with uv via
uv tool install --python 3.13 'ursa-ai[dashboard]'
A standard OpenAI setup needs no configuration file:
export OPENAI_API_KEY="..."
ursa
This starts the full-screen terminal app. Type / to browse commands,
# to choose an agent behavior, or @ to insert a workspace path.
You can chat with an LLM by simply typing into the terminal.
How are you?
Thanks for asking! I’m doing well. How are you today? What can I help you with?
Use the required # macro to route a prompt to another agent behavior:
#plan Write a python script to do linear regression using only numpy.
If you run subsequent agents, the last output will be appended to the prompt for the next agent.
So, to run the Planning Agent followed by the Execution Agent:
#plan Write a python script to do linear regression using only numpy.
...
#execute Execute the plan.
You can get a list of available command line options via
ursa --help
Web Dashboard
The URSA web interface can be launched with:
ursa-dashboard
or with
ursa-dashboard --host 127.0.0.1 --port 8080
This requires installing with the optional [dashboard] dependencies.
Development Team
URSA has been developed at Los Alamos National Laboratory as part of the ArtIMis project.
Notice of Copyright Assertion (O4958):
This program is Open-Source under the BSD-3 License. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
- Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
- Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
- Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Release files for ursa-ai 0.17.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| ursa_ai-0.17.2.tar.gz | 1.8 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ursa_ai-0.17.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 3.7 MB
Release files / ursa_ai-0.17.2.tar.gz
| Download URL | ursa_ai-0.17.2.tar.gz |
|---|---|
| Size | 1.8 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3e1d4d924df3c127375a0d71690742dcd81f60a937249771ce3fa7827e1e5483
|
|
BLAKE2b-256 checksum How to use checksums |
1272a28868bfa4a1b07fde4ec806f903f175e8fd8964cc26f5da97060bfd679b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.8.11
|
Release files / ursa_ai-0.17.2-py3-none-any.whl
| Download URL | ursa_ai-0.17.2-py3-none-any.whl |
|---|---|
| Size | 1.9 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d37af0aa45d35375afcd8a31c812bec52691dbcf9ff8945ff38f0aed870e343d
|
|
BLAKE2b-256 checksum How to use checksums |
4f17b0703ff51cbe519e7e7e4357d894dce34d5ecb2e67aa38a07dd4f85015ea
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.8.11
|
