AStackA composable framework for building AI applications.

1npm install @astack-tech/core @astack-tech/components
2# yarn
3yarn add @astack-tech/core @astack-tech/components
4# pnpm
5pnpm add @astack-tech/core @astack-tech/components

1import { Component } from '@astack-tech/core';
2
3class TextProcessor extends Component {
4  constructor() {
5    super({});
6    // Each component has default 'in' and 'out' ports
7    // We can customize them with Component.Port.I and Component.Port.O
8    Component.Port.I('text').attach(this); // Customize input port
9  }
10
11  // Standalone mode: direct processing
12  run(input: unknown): string {
13    const text = typeof input === 'string' ? input : String(input);
14    return text.toUpperCase();
15  }
16
17  // Pipeline mode: processing via port system
18  _transform($i: any, $o: any) {
19    $i('text').receive((input: unknown) => {
20      const output = this.run(input);
21      $o('out').send(output);
22    });
23  }
24}

1import { Pipeline } from '@astack-tech/core';
2import { TextSplitter, Embedder } from '@astack-tech/components';
3
4// Create text processing pipeline
5const pipeline = new Pipeline();
6
7// Add components to pipeline
8pipeline.addComponent('splitter', new TextSplitter({ chunkSize: 1000 }));
9pipeline.addComponent('embedder', new Embedder({ model: 'text-embedding-ada-002' }));

1// Method 1: Run component independently
2const splitter = new TextSplitter({ chunkSize: 1000 });
3const chunks = await splitter.run("This is a long text...");
4
5// Method 2: Run through pipeline
6const result = await pipeline.run('splitter.text', "This is another long text...");
7console.log(result);

1import { Agent } from '@astack-tech/components';
2import { Deepseek } from '@astack-tech/integrations/model-provider';
3import { createTool } from '@astack-tech/tools';
4
5// Create a tool
6const searchTool = createTool(
7  'search',
8  'Search the internet for information',
9  async (args) => {
10    // Implement search functionality
11    const query = args.query;
12    return { results: ["Search results for: " + query] };
13  },
14  {
15    type: 'object',
16    properties: {
17      query: { type: 'string', description: 'The search query' }
18    },
19    required: ['query']
20  }
21);
22
23// Create model provider
24const deepseek = new Deepseek({
25  apiKey: process.env.DEEPSEEK_API_KEY,
26  model: 'deepseek-chat'
27});
28
29// Create agent with model and tools
30const agent = new Agent({
31  model: deepseek,
32  tools: [searchTool],
33  systemPrompt: 'You are a helpful assistant that can search for information.',
34  verbose: true,
35  maxIterations: 3
36});
37
38// Run the agent
39const result = await agent.run("Help me research recent AI advances");