Documentation
Docs/Getting Started/Installation

Installation

Install the NxtOne agent and CLI in your local or production environment.

The NxtOne observation layer consists of two components: the runtime agent which instruments your application code in memory, and the Lens CLI which is used to authenticate, manage sync files, and verify connectivity locally.

1. Installing the Lens CLI

Install the CLI tool to manage local workspaces and authenticate with the NxtOne platform:

macOS (via Homebrew)
bash
brew install nxtone/tap/nxtone-lens
Linux (Direct Install)
bash
curl -fsSL https://next.platform.nxtone.ai/cli/install.sh | bash

2. Installing Language Agents

To inspect your application runtime, you must include the NxtOne agent packages. We officially support Java, Python, and TypeScript/JavaScript.

LanguageInstallation Command / Package CoordinatorArtifact ID / Module
JavaMaven / Gradle Dependencyio.nxtone:nxtone-agent
Pythonpip install nxtonenxtone
TypeScriptnpm install @nxtone/agent-ts@nxtone/agent-ts
JavaScriptnpm install @nxtone/agent-js@nxtone/agent-js
For Spring Boot projects, use the unified starter nxtone-spring-boot-starter. For standard Java programs, load the raw nxtone-agent.jar as a startup agent parameter.

3. Verifying Connectivity

Once you've configured your credentials, run the CLI verification command to ensure the local agent can successfully reach the NxtOne platform ingest server:

bash
# Authenticate your CLI session nxtone login # Verify local config and platform connectivity nxtone verify

If successful, you will see a green verification report indicating that the authentication token is valid and the server is fully reachable.

On This Page
What is NxtOne?Key FeaturesQuick StartInstall the agentAnnotate your applicationConfigure API keyConfiguration ReferenceAPI ExampleSupported StackLanguages & FrameworksNext Steps