Skip to content

nearai/docs

Repository files navigation

NEAR AI Documentation



NEAR AI Logo

Private. Intelligent. Yours.

Deploy to GitHub Pages Node.js Version Docusaurus License

Live DocumentationReport BugRequest Feature


About

This repository contains the official documentation for NEAR AI Cloud, a platform offering developers access to secure, private, verifiable AI models through a unified API.

Prerequisites

Before you begin, ensure you have the following installed:

  • Node.js >= 20.0.0 (Download)
  • npm (comes with Node.js)

Quick Start

Installation

# Clone the repository
git clone https://github.com/nearai/docs.git
cd docs

# Install dependencies
npm install

Local Development

# Start the development server
npm start

This command fetches the latest model data and starts a local development server at http://localhost:3000. Most changes are reflected live without restarting the server.

Build

# Generate static site
npm run build

This command generates static content into the build directory, ready to be served by any static hosting service.

Serve Build Locally

# Serve the production build
npm run serve

Test the production build locally before deploying.

Available Scripts

Command Description
npm start Start development server with hot reload
npm run build Build production-ready static site
npm run serve Serve the production build locally
npm run clear Clear Docusaurus cache
npm run fetch-models Fetch latest model data from API

Contributing

We welcome contributions to improve our documentation! Here's how you can help:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-improvement)
  3. Make your changes and test locally (npm start)
  4. Build to verify (npm run build)
  5. Commit your changes (git commit -m 'Add amazing improvement')
  6. Push to the branch (git push origin feature/amazing-improvement)
  7. Open a Pull Request

Documentation Guidelines

  • Use clear, concise language
  • Include code examples where applicable
  • Follow the existing documentation structure
  • Test all code snippets before submitting
  • Use proper markdown formatting

Documentation Standards

  • Markdown Files: Use .mdx extension for MDX support
  • Code Blocks: Include language identifiers for syntax highlighting
  • Links: Use absolute paths for internal links (e.g., /cloud/quickstart)
  • Images: Store in static/img/ and reference with absolute paths
  • Components: Create reusable React components in src/components/

Bug Reports & Feature Requests

Found a bug or have a feature request? Please open an issue with:

  • Clear title and description
  • Steps to reproduce (for bugs)
  • Expected vs actual behavior
  • Screenshots (if applicable)

Links

Support

Need help? Reach out through:

License

This project is licensed under the MIT License - see the LICENSE file for details.

About

NEAR AI Cloud Documentation

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •